Home Containers Container Registry How to

Connect the Docker CLI

How to connect your namespace to the Docker CLI

Reviewed on 24 May 2023 • Published on 25 February 2019

Docker is a tool which makes it easy to manage container images. You can use Docker to push and pull images to and from your Scaleway Container Registry. We show you how to set up Docker on your local computer to connect to your Container Registry.

Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

you are the Owner of the Scaleway Organization in which the actions will be carried out, or
you are an IAM user of the Organization, with a policy granting you the necessary permission sets

Requirements:

You have an account and are logged into the Scaleway console
You have created a Container Registry namespace
You have generated your API key
You have installed Docker on your local computer

Click Container Registry in the Containers section of the Scaleway Console side menu. The Container Registry namespaces dashboard displays.
Click «See more Icon», then Push Instructions next to the namespace you want to push to. A pop-up displays.
Copy the push instructions. Then click X to close the pop-up.
Open a terminal window on your local computer. Then log into the namespace by running the following command from the terminal:
```
docker login rg.fr-par.scw.cloud/mynamespace -u nologin -p [SCW_SECRET_KEY]
```
Important:
Replace [SCW_SECRET_KEY] with your API Secret Key and mynamespace with the name of your namespace.

Once logged in, a confirmation is displayed:
```
Login Succeeded
```

You are now logged in and ready to push and pull images to and from your Container Registry with Docker.