Skip to content

Manage a Registry

From Portainer Business Edition, you can manage Registries and Repositories.

Managing a Repository

Add a Tag

Adding a tag to an image hosted in the registry is an easy task with Portainer, it doesn't require type any commands in the CLI.

Go to Registries, choose the registry you want to manage and click browse.

managing

After that, you will see the repositories saved in that registry. Select the one you want to manage.

managing

The next step is to look at the top right of the screen, you will see a box with the section name Add tag, you only need write the name of the tag, select the image and click Add tag.

managing

If everything work as expected, you will see a pop up at the right top corner.

managing

Retag

Note: If you have hosted your own Docker registry, you need to add a specific environment variable to enable retag and deleting. The env is REGISTRY_STORAGE_DELETE_ENABLED=TRUE.

Another capability of Portainer Business Edition is Retagging the current images saved in a repository. To do this, you need to go to Registries, choose the registry you want to manage and click browse.

managing

After that, you will see the repositories saved in that registry. Select the image you want to Retag.

managing

After that, click Retag.

managing

Type the new tag for this image and click the

managing

If everything work as expected, you will see a pop-up confirming the action.

managing

Remove a Tag

Note: If you have hosted your own Docker registry, you need to add a specific environment variable to enable retag and deleting. The env is REGISTRY_STORAGE_DELETE_ENABLED=TRUE.

You can remove a tag from Portainer Business Edition. To do this, you need to go to Registries, choose the registry you want to manage and click browse.

managing

After that, you will see the repositories saved in that registry. Select the image you want to Remove.

managing

Select the image/tag and click Remove.

managing

You will be asked for confirmation, if you're sure, click Remove.

managing

If everything works as expected, you will see a pop-up confirming the action.

managing

Notes

Contribute to these docs.