> ## Documentation Index
> Fetch the complete documentation index at: https://helix-digitalocean.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS ECR Deployment

> Practical examples and patterns for typical AWS ECR deployment workflows

## Configure AWS CLI

<Warning>
  Ensure you have the necessary permissions to create and push to the ECR
  repository. Using Helix with ECR will NOT work unless you have the necessary
  permissions via the AWS CLI.

  [AWS CLI Documentation](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
</Warning>

```bash theme={null}
# Configure AWS credentials
aws configure
```

## Deploy to ECR

<Steps>
  <Step title="Add ECR instance">
    ```bash theme={null}
    helix add ecr --name staging
    ```

    <Note>
      If you don't have a project setup, you can do so with `helix init ecr`.
    </Note>
  </Step>

  <Step title="Push to ECR">
    ```bash theme={null}
    helix push staging 
    ```

    This will:

    * Create ECR repository if needed
    * Authenticate Docker with ECR
    * Tag and push the image
  </Step>

  <Step title="Deploy to ECS/EKS">
    Use the pushed image in your container orchestration:

    ```yaml theme={null}
    # ECS task definition
    image: 123456789.dkr.ecr.us-west-2.amazonaws.com/my-app:latest
    ```
  </Step>
</Steps>