Push Images to Your Registry

Learn how to authenticate with your DCR registry and push container images.

Prerequisites

• A created DCR registry
• Docker or Podman installed on your local machine
• Registry credentials (provided during registry creation)
• A container image to push

Step 1: Authenticate with Your Registry

Use the credentials provided during registry creation to log in:

docker login dcr.nexqloud.io/your-registry-name

When prompted, enter:

• Username: Your registry username
• Password: Your registry password/token

Step 2: Tag Your Image

Before pushing, tag your local image with your registry's endpoint:

docker tag local-image:tag dcr.nexqloud.io/your-registry-name/image-name:tag

Example:

docker tag myapp:latest dcr.nexqloud.io/dcp-dcr-demo-01/myapp:latest

Tagging Best Practices

• Use semantic versioning for production images (e.g., v1.0.0)
• Tag with latest for the most recent stable version
• Use environment tags like dev, staging, prod
• Include commit SHA for traceability

Step 3: Push Your Image

Push the tagged image to your registry:

docker push dcr.nexqloud.io/your-registry-name/image-name:tag

Example:

docker push dcr.nexqloud.io/dcp-dcr-demo-01/myapp:latest

Step 4: Verify the Push

1. Log in to the Nexqloud Console
2. Navigate to Container → DCR Container Registry
3. Click on your registry name
4. View your image in the Repositories tab

Working with Multiple Tags

You can push multiple tags of the same image:

# Tag with version
docker tag myapp:latest dcr.nexqloud.io/your-registry-name/myapp:v1.0.0

# Tag with environment
docker tag myapp:latest dcr.nexqloud.io/your-registry-name/myapp:production

# Push all tags
docker push dcr.nexqloud.io/your-registry-name/myapp:v1.0.0
docker push dcr.nexqloud.io/your-registry-name/myapp:production
docker push dcr.nexqloud.io/your-registry-name/myapp:latest

Using with Podman

If you're using Podman instead of Docker, the commands are nearly identical:

# Login
podman login dcr.nexqloud.io/your-registry-name

# Tag
podman tag local-image:tag dcr.nexqloud.io/your-registry-name/image-name:tag

# Push
podman push dcr.nexqloud.io/your-registry-name/image-name:tag

Troubleshooting

Authentication Failed

• Verify your credentials are correct
• Check if your registry name is spelled correctly
• Ensure your credentials haven't expired

Push Denied

• Confirm you have write permissions for the registry
• Verify the registry exists and is accessible
• Check your account has sufficient quota/credits

Slow Push

• Large images take longer to push
• Consider using multi-stage builds to reduce image size
• Check your internet connection speed

Next Steps

• Pull Images from Registry
• Manage Repositories