Manage a registry
The registry manager extends your container management experience by giving you the ability to browse defined registries and manipulate their content. By using this feature, container users enjoy the benefit of having a single interface to manage any Docker registry deployment, providing a consistent look and feel across any provider.
Adding a tag
From the menu select Registries, select the registry you want to manage then click browse. From the list, select the repository you want to manage.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3146734376-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwXVC6tYZrbL0dPoO2iBb%252Fuploads%252FHob1vVpK3mrwJgNPU57g%252F2.15-registries-manage.gif%3Falt%3Dmedia%26token%3Dcfe91130-4d66-43df-a9a6-f6b53c726f5f&width=768&dpr=4&quality=100&sign=8b47edca&sv=1)
In the Add tag section at the top-right of the page, enter the name of your tag, select the image from the dropdown, then click the Add tag button.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3146734376-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwXVC6tYZrbL0dPoO2iBb%252Fuploads%252Fvl5ZPAhwGua9qRz3GBki%252F2.15-registries-manage-addtag.png%3Falt%3Dmedia%26token%3D33e6fed5-59bc-4b8c-a607-752e00a0d707&width=768&dpr=4&quality=100&sign=706f5520&sv=1)
Retagging
If you host your own Docker registry, and you want the ability to retag images, you will need to add the following to your Docker registry's environment variables:
REGISTRY_STORAGE_DELETE_ENABLED=TRUE
From the menu select Registries, choose the registry you want to manage and click browse. From the list of repositories, select the repository you want to manage.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3146734376-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwXVC6tYZrbL0dPoO2iBb%252Fuploads%252FHob1vVpK3mrwJgNPU57g%252F2.15-registries-manage.gif%3Falt%3Dmedia%26token%3Dcfe91130-4d66-43df-a9a6-f6b53c726f5f&width=768&dpr=4&quality=100&sign=8b47edca&sv=1)
In the Tags section, locate the image you want to retag then click Retag to its right. Enter the new tag for the image then click the tick icon.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3146734376-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwXVC6tYZrbL0dPoO2iBb%252Fuploads%252FhA8CkhEF5kTsoyw5cwbR%252F2.15-registries-manage-retag.png%3Falt%3Dmedia%26token%3Db8d454a3-e15d-42d6-84a3-56624738ce8c&width=768&dpr=4&quality=100&sign=4a4ad7a0&sv=1)
Removing a tag
If you host your own Docker registry, and want the ability to remove tags, you will need to add the following to your Docker registry's environment variables:
REGISTRY_STORAGE_DELETE_ENABLED=TRUE
From the menu select Registries, select the registry you want to manage then click Browse. From the list, select the repository you want to manage.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3146734376-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwXVC6tYZrbL0dPoO2iBb%252Fuploads%252FHob1vVpK3mrwJgNPU57g%252F2.15-registries-manage.gif%3Falt%3Dmedia%26token%3Dcfe91130-4d66-43df-a9a6-f6b53c726f5f&width=768&dpr=4&quality=100&sign=8b47edca&sv=1)
Tick the checkbox next to the tag you want to remove then click Remove.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3146734376-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwXVC6tYZrbL0dPoO2iBb%252Fuploads%252FW0BSUaOtbK7MN2hB81to%252F2.15-registries-manage-removetag.gif%3Falt%3Dmedia%26token%3Dcb8d84f7-b1d9-463e-aa6b-26009bb9c7ed&width=768&dpr=4&quality=100&sign=2ce042ea&sv=1)
When the confirmation message appears, if you're sure, click Remove.
Last updated