How to configure and use the DigitalOcean Container Registry in Portainer

Prerequisites

Before starting, ensure you have:

• A DigitalOcean account
• A running Portainer instance
• Access to a Docker environment managed by Portainer

1. Create a DigitalOcean Container Registry

1. Log in to your DigitalOcean account.
2. From the left had menu, select Container Registry and then Create Registry.
3. Configure the registry:
   • Name: Choose a unique name.
   • Region: Select the appropriate region.
   • Plan: Select the commercial plan that fits your requirements.
4. Click Create.

For more information on DigitalOcean container registries, see the DigitalOcean documentation.

2. Generate an API token for Registry access

Next, create an API token that Portainer will use to authenticate with the registry.

1. From DigitalOcean, open API from the left hand menu.
2. Click Generate New Token.
3. Configure the token:
   • Validity: Set an expiration period if required.
   • Permissions: Enable Full Access so images can be pushed to the registry.
4. Generate the token.

Save the API token securely. It is only displayed once.

For more information on DigitalOcean APIs, see the DigitalOcean documentation.

3. Add the Registry in Portainer

1. Log in to Portainer.
2. In the left navigation menu, select Registries.
3. Click Add registry.
4. Specify it is a Custom Registry
5. Enter the registry details

• Name: A name for your registry
• Registry URL: registry.digitalocean.com
• Authentication toggled on
• Username: Your DigitalOcean account email
• Password: The API token you generated

Click Add registry to save the registry configuration.

Further information on Portainer registries can be found in the Portainer documentation.

4. Enable Registry browsing

To allow Portainer to browse repository contents:

1. In Registries, locate the registry you added.
2. Click Browse under Actions.
3. Select Configure this registry.
4. Enable the following settings:
   • TLS enabled
   • Disable certificate verification
5. Click Test configuration to confirm connectivity.
6. After the success notification appears, click Save configuration.

You can now browse the registry from Portainer.

5. Push an Image to the Registry

If the registry is empty, push an image from one of your Docker environments.

1. Open the Docker environment in Portainer.
2. Navigate to Images in the left hand menu.
3. Select an image to use as a test. For example: fluent-bit:latest
4. Click Tag.

Next, push the image:

1. Under the new image tag you have just created, click the Push icon (up arrow).
2. Select your DigitalOcean registry
3. Wait for the success notification confirming the image has been pushed.

6. Verify the Image in the Registry

1. Return to Registries in Portainer.
2. Click Browse on your DigitalOcean registry.

The pushed image should now appear in the repository list.

You can now deploy containers using images stored in your DigitalOcean Container Registry.

For more details on containers, see the Portainer documentation.

Try Portainer with 3 Nodes Free

If you're ready to get started with Portainer Business, 3 nodes free is a great place to begin. If you'd prefer to get in touch with us, we'd love to hear from you!