How to connect your namespace to the Docker CLI

Reviewed on July 15, 2025

Docker is a tool that 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.

Before you start

To complete the actions presented below, you must have:

A Scaleway account logged into the console
Owner status or IAM permissions allowing you to perform actions in the intended Organization
A valid API key
Docker installed on your local computer

Click Container Registry under the Storage or Containers sections of the Scaleway console side menu. The Container Registry namespaces dashboard displays.
Click more icon, then Push instructions next to the namespace you want to push to. A pop-up displays.
Copy the push instructions.
Open a terminal window on your local computer.
Run the following command to log into the namespace:
```
docker login rg.fr-par.scw.cloud/mynamespace -u nologin --password-stdin <<< "$SCW_SECRET_KEY"
```
Important
Replace "$SCW_SECRET_KEY" with your API secret key and mynamespace with the name of your namespace.

Once logged in, 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.