> ## Documentation Index
> Fetch the complete documentation index at: https://gcore-doc-1046.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage container registries

All created Container Registries appear in the Gcore Customer Portal on the **Container Registries** page:

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/container-registry-page.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=9d79ab4bae9746a38dcc303c5e0b7dbb" alt="Container registry page in the Customer Portal" width="4244" height="1520" data-path="images/docs/cloud/container-registry/manage-container-registries/container-registry-page.png" />
</Frame>

You can change the storage limit for a registry, configure its users and images, or delete the registry if you no longer need it. If you have a large number of registries, you can also use search to find the one that you're looking for.

## Change storage limit

You can adjust your storage limit to host more images in the container registry or optimize storage according to your usage and container requirements.

To change the storage limit:

1\. In the Gcore Customer Portal, navigate to **Cloud** > **Container Registries**.

2\. Find the registry you want to configure and click the three-dot icon next to it.

3\. Click **Change storage limit**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/container-registry-change-limit.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=fdfaffe452edb883a57f47a682bea68f" alt="Container registry settings with change limit button highlighted" width="4424" height="1344" data-path="images/docs/cloud/container-registry/manage-container-registries/container-registry-change-limit.png" />
</Frame>

4\. Enter a new limit and click **Save** to apply the changes.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/set-new-storage-limit.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=ff4512338016dd71e07acf8ef15a25fc" alt="A confirmation dialog to change storage limit" width="476" height="269" data-path="images/docs/cloud/container-registry/manage-container-registries/set-new-storage-limit.png" />
</Frame>

The storage limit has been changed.

## Manage images in the container registry

Open the **Images** tab to view the following information about the images within your Container Registry:

* Image name

* Artifacts associated with the image

* The number of times the image was pulled from the registry

* The date and time when the image was last modified

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/images-tab-cropped.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=31018e6ed3d05d1368bfcbb323e003f5" alt="Images tab in the registry overview" width="4180" height="1520" data-path="images/docs/cloud/container-registry/manage-container-registries/images-tab-cropped.png" />
</Frame>

You can do the following actions with images: view and manage related artifacts, pull images from the registry, or delete them. You can also search through the images to find the one that you need.

### View and manage image artifacts

To view image artifacts, click the image name to open it. On the **Artifacts** page, you can check the artifact name, its tags, size, and the last associated push and pull operations. You can also search through the artifacts.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/image-artifacts.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=c07a9284796381ae2d5fd17e81ff594e" alt="Images tab with the list of image artifacts" width="4240" height="1812" data-path="images/docs/cloud/container-registry/manage-container-registries/image-artifacts.png" />
</Frame>

To delete an artifact or its tag:

1\. Find the needed artifact and click the three-dot icon next to it.

2\. Select the required action from the dropdown and proceed with the instructions.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/delete-image-artifact.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=e1a0889dc5dc8376eca5d8ef17305c23" alt="Image settings with the highlighted delete and delete tags buttons" width="4216" height="1276" data-path="images/docs/cloud/container-registry/manage-container-registries/delete-image-artifact.png" />
</Frame>

You can also apply group actions to multiple artifacts. To do so, select checkboxes next to the artifacts you want to manage and choose the needed action from the **Group actions** dropdown.

### Delete an image

1\. On the **Images** tab, find the image you want to remove.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/delete-image.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=b7e7ecd9b6a7905f8ef739558316dc01" alt="Image settings with the highlighted delete button" width="4016" height="1348" data-path="images/docs/cloud/container-registry/manage-container-registries/delete-image.png" />
</Frame>

2\. Click the three-dot icon and select **Delete**.

3\. Confirm your action by typing "Delete" in the text field.

4\. Click **Delete Image**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/confirm-image-deletion.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=51a51312f1bc49b1803419b53b6eb3c3" alt="Image deletion dialog" width="478" height="186" data-path="images/docs/cloud/container-registry/manage-container-registries/confirm-image-deletion.png" />
</Frame>

Your image has been removed from the registry.

### Delete multiple images with group actions

You can simultaneously delete multiple images with **Group actions**. To do so, select checkboxes next to the images you want to manage and use the required action from the dropdown.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/image-group-actions.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=acc374cee1423a09eeb086bf2d45bf7a" alt="Group actions dropdown on the Images tab" width="2692" height="932" data-path="images/docs/cloud/container-registry/manage-container-registries/image-group-actions.png" />
</Frame>

## Manage users in the container registry

Open the Users tab to view the following information about created users within your Container Registry:

* Username

* User permissions

* The date and time when the user was created

* (Optional) If the password expiration date was set during user creation, this information will be displayed in the **Expires at** column.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/users-tab.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=3c08b90e9555be920b2c8af7fa19a2ec" alt="Users tab in the registry overview" width="2692" height="932" data-path="images/docs/cloud/container-registry/manage-container-registries/users-tab.png" />
</Frame>

You can change user permissions, generate a new user password, or delete the user from the registry.

<Tip>
  **Tip**

  For details on how to create a user, check the [Create a Container Registry](/cloud/container-registry/create-container-registry) guide.
</Tip>

### Change user permissions

For each user, you can configure the following permissions:

* **Pull images** : this is helpful if you'd like to prevent unauthorized or accidental changes to the Container Registry. In this case, you can restrict permissions for some users to pull operations only.

* **Push and push images** : this permission grants full access to the registry and allows users to pull and push any new images or image versions to the registry.

To change user permissions:

1\. On the **Users** tab, find the user you want to delete and click the three-dot icon next to it.

2\. Select **Change permissions**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/change-user-permissions.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=e4656a6c63554df5235b1b438d8cea6e" alt="Users settings with the highlighted change permissions button" width="2624" height="932" data-path="images/docs/cloud/container-registry/manage-container-registries/change-user-permissions.png" />
</Frame>

3\. Update the permissions as needed and click **Save** to apply the changes.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/select-new-user-permissions.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=780bfab95ea1d7a27b1eb2388dada3dc" alt="Change permissions dialog" width="933" height="276" data-path="images/docs/cloud/container-registry/manage-container-registries/select-new-user-permissions.png" />
</Frame>

### Reset user password

A user password is automatically generated during user creation. If the password has expired or the user can't remember it, you can regenerate a password as follows:

1\. On the **Users** tab, find the user you want to delete and click the three-dot icon next to it.

2\. Select **Reset password**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/reset-user-password.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=555d371824140354981e35eb3ccbd15f" alt="Users settings with the highlighted reset password button" width="2624" height="932" data-path="images/docs/cloud/container-registry/manage-container-registries/reset-user-password.png" />
</Frame>

3\. Confirm password reset.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/confirm-password-reset.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=dc3ee73c183eb582eb9fec4a0c06795d" alt="Reset password confirmation dialog" width="474" height="185" data-path="images/docs/cloud/container-registry/manage-container-registries/confirm-password-reset.png" />
</Frame>

4\. Copy the password and save it locally. Keep in mind that you won't be able to view it again.

### Delete a user

1\. On the **Users** tab, find the user you want to delete and click the three-dot icon next to it.

2\. Select **Delete**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/delete-user.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=1df9f203bf190d87627d2aa43a4a3044" alt="Users settings with the highlighted delete button" width="2624" height="932" data-path="images/docs/cloud/container-registry/manage-container-registries/delete-user.png" />
</Frame>

3\. Confirm your action by typing "Delete" in the text field.

4\. Click **Delete user**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/confirm-user-deletion.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=fe025d8ca987fa92341cfd5e60f1dbb9" alt="Delete user confirmation dialog" width="476" height="206" data-path="images/docs/cloud/container-registry/manage-container-registries/confirm-user-deletion.png" />
</Frame>

### Manage multiple users with group actions

There's an option to simultaneously delete multiple users or change their permissions using **Group actions**. To do so, select checkboxes next to the users you want to modify and then choose the needed action from the **Group actions** dropdown.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/group-actions-users.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=c59542f7e6ca5c12dea377e493798818" alt="Users settings with the highlighted group actions dropdown" width="2128" height="796" data-path="images/docs/cloud/container-registry/manage-container-registries/group-actions-users.png" />
</Frame>

## Delete a registry

<Warning>
  **Warning**

  If you delete a Container Registry, you will lose all data stored there. This action can't be reverted.
</Warning>

To delete a registry:

1\. In the Gcore Customer Portal, navigate to **Cloud** > **Container Registries**.

2\. Find the registry you want to configure and click its name to open it.

3\. In the top-right corner of the screen, click the **Actions** dropdown and select **Delete**.

<Frame>
  <img src="https://mintcdn.com/gcore-doc-1046/Cf8gHikmtl4aL2hb/images/docs/cloud/container-registry/manage-container-registries/delete-registry.png?fit=max&auto=format&n=Cf8gHikmtl4aL2hb&q=85&s=5df0016f4f907c3a442df54d4e2277f4" alt="Container registry page with the highlighed delete button" width="4200" height="1012" data-path="images/docs/cloud/container-registry/manage-container-registries/delete-registry.png" />
</Frame>

4\. Type "Delete" to validate your action.

The registry has been removed.
