|  | 
| 1 | 1 | --- | 
| 2 | 2 | title: Registries - Use & manage your registries | 
| 3 | 3 | excerpt: Learn how to use and manage your public and private registries | 
| 4 |  | -updated: 2025-05-05 | 
|  | 4 | +updated: 2025-10-28 | 
| 5 | 5 | --- | 
| 6 | 6 | 
 | 
| 7 | 7 | ## Objective | 
| @@ -31,7 +31,7 @@ The Public Cloud provides a default registry called `shared registry`, where use | 
| 31 | 31 | 
 | 
| 32 | 32 | > [!warning] | 
| 33 | 33 | > | 
| 34 |  | ->This `shared registry` can help you perform your tests, but **should not be used in production**, as we reserve the right to delete its content if deemed necessary. The images pushed to this registry are for AI Tools workloads only, and will not be accessible for external uses. | 
|  | 34 | +>This `shared registry` can help you perform your tests, but **should not be used in production**, as we reserve the right to delete its content if deemed necessary. The images pushed to this registry are for AI Tools workloads only, and will not be accessible for external uses. | 
| 35 | 35 | > | 
| 36 | 36 |  | 
| 37 | 37 | This is why it can be interesting to add and manage other registries. We can either do this by using the OVHcloud Control Panel (UI) or the `ovhai` CLI. | 
| @@ -82,6 +82,13 @@ Using your own and private registries is the best way to use your images without | 
| 82 | 82 | - Private Docker registry | 
| 83 | 83 | - GitHub registry / packages | 
| 84 | 84 | 
 | 
|  | 85 | +> [!warning]  | 
|  | 86 | +> | 
|  | 87 | +> **Port restriction:** Only port **443** is supported for registry connections. If you attempt to add a registry URL with a non-**443** port (e.g., `8443`), the system will enforce port 443. This may lead to errors or connection timeouts if the registry is not configured to accept HTTPS on port 443. | 
|  | 88 | +>   | 
|  | 89 | +> For self-hosted registries using non-443 ports, consider configuring a **reverse proxy** (e.g., Nginx, HAProxy) to map traffic from **443** to your desired port (e.g., 8443). | 
|  | 90 | +> | 
|  | 91 | + | 
| 85 | 92 | We will see how to implement each of these registries and use them through AI Tools. | 
| 86 | 93 | 
 | 
| 87 | 94 | > [!primary] | 
| @@ -119,35 +126,36 @@ To add your registry, you can either use the OVHcloud Control Panel (UI) or the | 
| 119 | 126 | 
 | 
| 120 | 127 | During this step, you will be asked your user's credentials (user ID and password). You can use the default user (administrator) credentials, which were obtained at the first part of the `Create and configure a new private registry` step, or those of another user if you have created one. | 
| 121 | 128 | 
 | 
| 122 |  | -##### Using UI | 
| 123 |  | - | 
| 124 |  | -To add your private registry via UI, log in to the [OVHcloud Control Panel](/links/manager), go to the `Public Cloud`{.action} section, then to the `AI Dashboard` section which is located under `AI & Machine Learning`. | 
| 125 |  | - | 
| 126 |  | -{.thumbnail} | 
| 127 |  | - | 
| 128 |  | -By default, you will be redirected to the `Dashboard`{.action} panel. To add a custom registry URL, click the `Docker Registries`{.action} button. Once there, click the `+ Add`{.action} button to add your private Docker registry. | 
| 129 |  | - | 
| 130 |  | -Here, you will need to provide the credentials of your registry along with its URL. | 
| 131 |  | - | 
| 132 |  | -{.thumbnail} | 
| 133 |  | - | 
| 134 |  | -When you have finished filling in the form, click `Add`{.action}. | 
| 135 |  | - | 
| 136 |  | -##### Using CLI | 
| 137 |  | - | 
| 138 |  | -To add your private Harbor registry via CLI, use: | 
| 139 |  | - | 
| 140 |  | -``` {.console} | 
| 141 |  | -ovhai registry add <registry-url> | 
| 142 |  | -``` | 
| 143 |  | - | 
| 144 |  | -Once your registry is added, you should see it in your registries list. You can then use any images pushed on this registry for your AI Training jobs and AI Deploy apps. | 
|  | 129 | +> [!tabs] | 
|  | 130 | +> Using the Control Panel (UI) | 
|  | 131 | +>> | 
|  | 132 | +>> To add your private registry via UI, log in to the [OVHcloud Control Panel](/links/manager), go to the `Public Cloud`{.action} section, then to the `AI Dashboard` section which is located under `AI & Machine Learning`. | 
|  | 133 | +>>  | 
|  | 134 | +>> {.thumbnail} | 
|  | 135 | +>>  | 
|  | 136 | +>> By default, you will be redirected to the `Dashboard`{.action} panel. To add a custom registry URL, click the `Docker Registries`{.action} button. Once there, click the `+ Add`{.action} button to add your private Docker registry. | 
|  | 137 | +>>  | 
|  | 138 | +>> Here, you will need to provide the credentials of your registry along with its URL. | 
|  | 139 | +>>  | 
|  | 140 | +>> {.thumbnail} | 
|  | 141 | +>>  | 
|  | 142 | +>> When you have finished filling in the form, click `Add`{.action}.  | 
|  | 143 | +>> | 
|  | 144 | +> Using ovhai CLI | 
|  | 145 | +>> | 
|  | 146 | +> To add your private Harbor registry via CLI, use: | 
|  | 147 | +>  | 
|  | 148 | +> ``` {.console} | 
|  | 149 | +> ovhai registry add <registry-url> | 
|  | 150 | +> ``` | 
|  | 151 | +>  | 
|  | 152 | +> Once your registry is added, you should see it in your registries list. You can then use any image pushed on this registry for your AI Training jobs and AI Deploy apps. | 
| 145 | 153 | 
 | 
| 146 | 154 | #### Push an image to your registry | 
| 147 | 155 | 
 | 
| 148 | 156 | > [!warning] | 
| 149 | 157 | > | 
| 150 |  | ->Be careful for the following, we will use the displayed URL. This version does not contain the `https://` part, which is present in the URL given by the Public Cloud. | 
|  | 158 | +>Be careful with the following, as we will use the displayed URL. This version does not contain the `https://` part, which is present in the URL given by the Public Cloud. | 
| 151 | 159 | > | 
| 152 | 160 | 
 | 
| 153 | 161 | Log in to your private registry, using a user with write rights to your registry project, with the following command: | 
| @@ -261,27 +269,28 @@ Once your image is pushed on your GitHub account, you will need to add your GitH | 
| 261 | 269 | 
 | 
| 262 | 270 | You will be asked your GitHub credentials. | 
| 263 | 271 | 
 | 
| 264 |  | -##### Using UI | 
| 265 |  | - | 
| 266 |  | -Log in to the [OVHcloud Control Panel](/links/manager), go to the `Public Cloud`{.action} section, then to the `AI Dashboard` section which is located under `AI & Machine Learning`. | 
| 267 |  | - | 
| 268 |  | -{.thumbnail} | 
| 269 |  | - | 
| 270 |  | -By default, you will be redirected to the `Dashboard`{.action} panel. To add a custom registry URL, click the `Docker Registries`{.action} button. Once there, click the `+ Add`{.action} button to add your private Docker registry. | 
| 271 |  | - | 
| 272 |  | -Here, you will need to provide your GitHub credentials along with the registry URL. | 
| 273 |  | - | 
| 274 |  | -{.thumbnail} | 
| 275 |  | - | 
| 276 |  | -When you have finished filling in the form, click `Add`{.action}. | 
| 277 |  | - | 
| 278 |  | -##### Using CLI | 
| 279 |  | - | 
| 280 |  | -```console | 
| 281 |  | -ovhai registry add ghcr.io | 
| 282 |  | -``` | 
| 283 |  | - | 
| 284 |  | -Once your registry is added, you should see it in your registries list. | 
|  | 272 | +> [!tabs] | 
|  | 273 | +> Using the Control Panel (UI) | 
|  | 274 | +>> | 
|  | 275 | +>> Log in to the [OVHcloud Control Panel](/links/manager), go to the `Public Cloud`{.action} section, then to the `AI Dashboard` section which is located under `AI & Machine Learning`. | 
|  | 276 | +>>  | 
|  | 277 | +>> {.thumbnail} | 
|  | 278 | +>>  | 
|  | 279 | +>> By default, you will be redirected to the `Dashboard`{.action} panel. To add a custom registry URL, click the `Docker Registries`{.action} button. Once there, click the `+ Add`{.action} button to add your private Docker registry. | 
|  | 280 | +>>  | 
|  | 281 | +>> Here, you will need to provide your GitHub credentials along with the registry URL. | 
|  | 282 | +>>  | 
|  | 283 | +>> {.thumbnail} | 
|  | 284 | +>>  | 
|  | 285 | +>> When you have finished filling in the form, click `Add`{.action}. | 
|  | 286 | +>> | 
|  | 287 | +> Using ovhai CLI | 
|  | 288 | +>> | 
|  | 289 | +>> ```console | 
|  | 290 | +>> ovhai registry add ghcr.io | 
|  | 291 | +>> ``` | 
|  | 292 | +>>  | 
|  | 293 | +>> Once your registry is added, you should see it in your registries list. | 
| 285 | 294 | 
 | 
| 286 | 295 | #### Use your GitHub registry images with OVHcloud AI Tools | 
| 287 | 296 | 
 | 
|  | 
0 commit comments