Use custom build registry

Before you configure a custom build registry, you need:

• An ECR registry, Google Artifact Registry repository, or Azure Container Registry in your cloud account.
• A cloud integration with Docker Registries and Docker Registry Push selected, and the corresponding cloud permissions.
• Saved registry credentials with Push access (write images) enabled and access permitted for the new project.

You can select a build registry only when you create a project. You cannot change this selection on an existing project.

If the registry controls are unavailable for your account, contact Northflank support about feature availability.

When your project uses a custom build registry:

1. Northflank builds your code with your configured build method.
2. Northflank pushes the resulting image to the project's selected registry.
3. Deployments that use the build pull the image from that registry.

Keep the registry and its credentials available for future builds and deployments. The project registry selection does not change the source of external images that you deploy.

If you need a cloud integration, follow the provider setup instructions first.

1. Open Integrations → Registries in your team account.
2. If this is your first registry, select Add registry integration. Otherwise, select Add registry.
3. Enter a name and select Elastic Container Registry, Google Artifact Registry, or Azure Container Registry.
4. Select a cloud integration with registry pull and push permissions.
5. Enter the registry URL and the additional values for your provider, as shown below.
6. Enable Push access (write images).
7. Select Add registry.

Use your own registry values. The Google Artifact Registry URL includes both the Google project ID and the repository name, builds in this example.

For ECR, the region must match the registry URL. A sovereign registry requires an AWS European Sovereign Cloud integration.

If the integration or registry is missing from a selector, see registry troubleshooting.

The PaaS mode uses Northflank's managed registry. The Self-hosted mode uses the registry linked through your selected credentials.

1. Select Create project on your team dashboard.
2. Expand Advanced options and find Docker registry settings.
3. Set Registry mode to Self-hosted.
4. Select your saved credentials under Registry.
5. Complete the project configuration and select Create project.

Your organization or team can disable the managed registry. In that case, you must select a supported registry with push access before you create a project. A team cannot override an organization restriction.

To view an existing project's registry, open the project's Settings page. Find the Docker registry settings section. These controls are read-only.