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

1. Click Container Registry in the Containers section of the Scaleway console side menu. The Container Registry namespaces dashboard displays.

2. Click more icon, then Push instructions next to the namespace you want to push to. A pop-up displays.

3. Copy the push instructions.

4. Open a terminal window on your local computer.

5. 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.