Use custom build registry

Use your cloud provider's Docker registry to store build images instead of Northflank's managed registry. Supported providers are Azure, AWS, and GCP.

This can only be configured when creating a new project.

Your BYOC provider integration must have these features enabled:

• Docker Registries: Allows pulling images from your registry
• Docker Registry Push: Allows pushing built images to your registry

If these features are not enabled, you cannot create a custom registry integration.

1. Navigate to Integrations in your team settings

2. Click Registries → Add registry

3. Enter a registry name and select your container registry provider (Azure, AWS, or GCP)

4. Select an existing BYOC integration or create a new one for Azure, AWS, or GCP

5. Enter the provider-specific registry settings:

   • GCP: Registry URL and project ID
   • AWS: Registry URL and region
   • Azure: Registry URL and resource group

6. Under Select the permissions you want to grant to this registry, enable Push access (write images)

7. Click Add registry

The registry is now available for use in new projects.

1. Create a new project

2. Under Advanced options, expand Docker Registry settings

3. Set Registry Mode to Self Hosted

4. Under Registry, select your custom registry integration

5. Click Create project

All builds in this project will now push images to your custom registry.