> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/self-managed-hivel-deployment/on-premises-generic/hivel-on-premises-deployment-guide-generic/registry-access-configuration.md).

# Registry Access Configuration

#### Why AWS CLI Is Required?

Hivel's Docker images are hosted on Amazon ECR regardless of your deployment target. You need AWS CLI configured with Hivel-provided credentials to pull them. No AWS account of your own is needed. Only the registry access Hivel provides.

### Step 1: Configure AWS CLI

Run the following command on the host:

```
aws configure
```

When prompted, enter:

* **AWS Access Key ID:** \[Hivel-provided access key]
* **AWS Secret Access Key:** \[Hivel-provided secret key]
* **Default region name:** `ap-south-1`
* **Default output format:** `json`

### Step 2: Verify AWS Credentials

Run:

```
aws sts get-caller-identity
```

**Success:** Returns a JSON object containing Account, UserId, and Arn\
**Failure:** "Unable to locate credentials" error means `aws configure` was not completed or saved to the wrong profile. Re-run `aws configure` and verify with `cat ~/.aws/credentials`.

### Step 3: Authenticate to Hivel's Image Registry

Run:

```
aws ecr get-login-password --region ap-south-1 | \
  docker login --username AWS --password-stdin \
  730335373269.dkr.ecr.ap-south-1.amazonaws.com
# Should show: Login Succeeded
```

**Success:** Output shows `Login Succeeded`\
**Failure:** See Registry pull failed in [Troubleshooting](https://docs.hivel.ai/self-managed-hivel-deployment/on-premises/troubleshooting)<br>

> #### Alternative: Use Private Registry Mirror (Optional)
>
> If your organization prohibits direct AWS ECR access, mirror Hivel's images into your own private registry (Harbor, Nexus, GitLab Registry, etc.). Update `services/vm/docker-compose.yml` and `deploy.sh` to reference your registry by changing the `ECR_REGISTRY` and `AWS_REGION` variables.

{% columns %}
{% column %} <a href="/self-managed-hivel-deployment/on-premises-generic/hivel-on-premises-deployment-guide-generic/project-setup.md" class="button primary" data-icon="backward">Back to Project Setup</a>
{% endcolumn %}

{% column %}

{% endcolumn %}

{% column %} <a href="/self-managed-hivel-deployment/on-premises-generic/hivel-on-premises-deployment-guide-generic/environment-configuration.md" class="button primary" data-icon="forward">Environment Configuration</a>
{% endcolumn %}
{% endcolumns %}