v1

Run /

Run an image from a container registry

You can run images from container registries in three different ways on Northflank:

  • As a continuously running service
  • As a regularly scheduled cron job
  • As a manually-run job

Requirements

You'll need the following to get started:

  • an image hosted on a container registry
  • (optional) credentials for the container registry if it is a private image

You can create a new continuously-running deployment service, a scheduled cron job or a manual job with an external image as the source.

You will need to enter the full image path and, if the image is private, select the appropriate registry credentials. If you do not have the correct credentials saved to your account you can click the credentials drop-down and select 'add new credential'.

Image paths

Image paths include the registry url, username, image, and sometimes version, in the format:

[registry-url]/[account]/[image]:[version]

For example:

docker.io/nginxinc/nginx-unprivileged:latest

Northflank will automatically detect the registry and relevant credentials.

If you do not include the registry Northflank will default to Docker Hub, and if you do not specify an account Northflank will default to Library. nginx:latest would therefore become docker.io/library/nginx:latest

Verify image

Northflank will attempt to automatically verify the image from the path you have entered. If the path cannot be verified, you will be prompted to either select your credentials or check the image path is correct.

If you do not have the necessary credentials saved, select Add new credential +.

If entering a path or selecting credentials fail to trigger automatic verification, you can manually verify by clicking the verify button above the image path field.

© 2022 Northflank Ltd. All rights reserved.