Save registry credentials | Run | Northflank Application docs

Run /

Save registry credentials

You can save external registry credentials in your account and use them to authorise when selecting external Docker images for deployment in services or jobs. You can view and add credentials by navigating to the registries section under integrations in your account settings.

You can enable the restriction of credentials on your account to specific projects, toggle restrictions on and select the projects you want to access the credentials in.

You can enter your credentials by selecting the registry and entering your username and password, or username and personal access token/API key depending on the registry.

Click here to add registry credentials.
Saving registry credentials in the Northflank application

Container registries

DockerHub (

To authenticate to DockerHub simply enter your DockerHub username and password. Alternatively you can create an access token to use in place of your password. You can do this from on the security page in your Docker account settings, the token should include read access permission.

Google Container Registry (

To authenticate to a Google Container Registry select your Google registry location from the drop-down list on Northflank. On Google Cloud Platform create or use a current service account with the Storage Object Viewer role and create a new key . Download the JSON keyfile and import it to Northflank.

GitHub Container Registry (

To authenticate to GitHub Container Registry you can create a personal access token on your GitHub account. You can create a personal access token with the required read: packages permission in developer settings, on your GitHub settings page.

GitLab (

To authenticate to GitLab enter your username and personal access token . Personal access tokens, with the permission read registry, can be created in your GitLab preferences on the access tokens page. If you are using a self-hosted GitLab instance, make sure you use your own domain for verification and image paths (for example

Authenticate with JSON

You can alternatively authenticate to a container registry by providing your Do