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.

DockerHub (registry.hub.docker.com)

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 (gcr.io)

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 (ghcr.io)

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 (registry.gitlab.com)

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 registry.yourdomain.com).

You can alternatively authenticate to a container registry by providing your Docker config.json, which consists of your username and password/token encoded in base 64, separated by a colon.

{
  "auths": {
    "[registry authentication url]": {
      "auth": "[Your auth key (username:password in base 64)]"
    }
  }
}