## Push images to Harbor registry

URL: https://docs.atlan.com/product/capabilities/build-apps/partner-with-us/how-tos/push-images-to-harbor-registry

> Push your containerized application images to Atlan's Harbor registry for staging and deployment within the partner program

Push your Docker images to Atlan's Harbor container registry to deploy applications within the partner program. This process enables you to store, version, and distribute your containerized applications through Atlan's infrastructure.

## Before you begin

Make sure you have:

1. Installed Docker on your development system
2. Packaged your application as a Docker image following the [Package app with Docker](https://docs.atlan.com/llms/platform/build-apps/package-app-with-docker/llms.txt) guide
3. Received Harbor registry credentials from Atlan support team including username (`atlan-robot-{partner-name}`) and password. If you haven't received credentials, [submit a support request](https://docs.atlan.com/support/submit-request)

## Authenticate with registry

Before pushing images, authenticate with Harbor registry to establish secure access.

1. Open your terminal and log in to Harbor registry using your provided credentials:

 ```bash
 docker login registry.atlan.com -u atlan-robot-partner-name
 ```

 - Replace `atlan-robot-partner-name` with your actual username provided by Atlan.

2. Enter your secure password when prompted. Docker stores your credentials securely for subsequent operations. You see a confirmation message indicating successful authentication.

## Push images to staging

After authentication, tag and push your Docker images to the staging environment where Atlan validates your container before production deployment.

1. Tag your local Docker image with Harbor registry path:

 ```bash
 docker tag my-app:latest registry.atlan.com/app-name-staging/main:latest
 ```

 - Replace `my-app:latest` with your local image name and tag, `app-name-staging` with your project name provided by Atlan, and `main:latest` with your desired image repository and tag.

 The tag format follows the pattern: `registry.atlan.com/{project-name}/{repository}:{tag}`

2. Push the tagged image to Harbor registry. Docker uploads your image layers to the registry. The process displays upload progress for each layer. Large images may take several minutes to upload depending on your network connection.

 ```bash
 docker push registry.atlan.com/app-name-staging/main:latest
 ```

3. Verify your image upload by pulling the image:

 ```bash
 docker pull registry.atlan.com/app-name-staging/main:latest
 ```

 This confirms your image is available from the registry and ready for deployment validation.

## Need help

If you encounter issues with registry authentication or image uploads, [submit a support request](https://docs.atlan.com/support/submit-request) or contact your Atlan partnership team.

## Next steps

Your containerized application is now available in Atlan's Harbor registry. The Atlan partnership team can access your staging images for compatibility testing, security scanning, and deployment validation before promoting to production environments.

---