> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro remote

<Info>
  This command is only available on Astro.
</Info>

<Warning>
  **Known issue in Astro CLI 1.38.0 (resolved in 1.38.1)**

  Astro CLI 1.38.0 installs Remote Execution Agent Python and system dependencies from `requirements.txt` and `packages.txt` instead of `requirements-client.txt` and `packages-client.txt` when you run `astro remote deploy`. As a result, dependencies meant for the client may not be installed on the Remote Execution Agent as expected. Upgrade to Astro CLI 1.38.1 or later to resolve this issue.
</Warning>

The `astro remote` command group enables workflows for building and deploying remote client images as part of Remote Execution Deployments.

## astro remote deploy

Builds and deploys a remote client image from your Astro project to a specified remote registry.

### Usage

```sh wrap theme={null}
astro remote deploy
```

### Options

| Option               | Description                                                                                                                     | Possible Values                                           |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| `--build-secrets`    | Mimics `docker build --secret` flag. See [Build Secrets](https://docs.docker.com/build/building/secrets/) for more information. | String array Example input: `id=mysecret,src=secrets.txt` |
| `-h`, `--help`       | Help for the command.                                                                                                           | N/A                                                       |
| `-i`, `--image-name` | Name of a custom image to deploy, or image name with custom tag. The image must be present on the local machine.                | String (image name)                                       |
| `--platform`         | Target platform for client image build. Defaults to host machine platform.                                                      | String. For example, `linux/amd64` or`linux/arm64`        |

### Examples

Deploy with a specific platform:

```sh wrap theme={null}
$ astro remote deploy --platform linux/amd64,linux/arm64
```

Deploy a pre-built image:

```sh wrap theme={null}
$ astro remote deploy --image-name my-custom-image:tag

```

Deploy with build secrets:

```sh wrap theme={null}
$ astro remote deploy --build-secrets id=mysecret,src=secrets.txt
```