External Docker Registries

Codefresh enables you to integrate with several Docker container registries, including:

For a different registry choose to configure using the Other option.

The registries can either be public or private.

General configuration

To configure your registries go to your Account Configuration, by clicking on Account Settings on the left sidebar. On the first section called Integrations click the Configure button next to Docker Registry.

Codefresh Account Integration

Add a new registry configuration from the drop down.

Add Docker Registry

Each configuration must be given a unique name, which you can later reference in a codefresh.yml file.

Specify Docker Registry Name

Pushing an image

Once your registry configuration is all set up you can start pushing you images to it.

Codefresh provides you with two options of how to push an image to a registry.

Using the Pipelines view

  1. Navigate to a repository Pipelines view
  1. Under Build and Unit Test select your preconfigured registry.

Pipeline Registry

Using a codefresh.yml file

In a push step you can place your registry configuration name in the registry field


  type: push
  description: Free text description
  candidate: ${{build_step}}
  tag: ${{CF_BRANCH}}
  registry: <your-registry-configuration-name>