# 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.

## Prerequisites

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.

## Add a custom Docker registry

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.

## Use in a project

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.

## Next steps

- [Build from a Git repository: Start building from your linked Git repositories in minutes.](/v1/application/build/build-code-from-a-git-repository)
- [Inject build arguments: Pass secrets and configuration settings to your builds.](/v1/application/build/inject-build-arguments)
- [Run an image continuously: Deploy a built image as a continuously-running service.](/v1/application/run/run-an-image-continuously)
- [Run an image once or on a schedule: Run an image manually or on a cron schedule.](/v1/application/run/run-an-image-once-or-on-a-schedule)