---
title: How to push images to your namespace
description: Learn how to push container images to Scaleway's Container Registry.
tags: push-image namespace container-registry
dates:
  validation: 2025-07-01
  posted: 2019-02-25
---
import Requirements from '@macros/iam/requirements.mdx'


After [configuring Docker on your local machine](/container-registry/how-to/connect-docker-cli/), you can use it to pull images from their library and push them to your Container Registry. This page shows you how to pull, tag, and push a first image to your Scaleway Container Registry namespace, using an Ubuntu image as an example.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- A [Container Registry namespace](/container-registry/how-to/create-namespace/)
- [Docker](https://www.docker.com/) installed on your local computer
- Access to your [namespace](/container-registry/how-to/connect-docker-cli/)


1. Open a terminal window on your local computer.
2. Pull the latest release of the [Ubuntu](https://hub.docker.com/_/ubuntu/) Docker image:
    ```bash
    docker pull ubuntu:latest
    ```
3. Tag the image:
    ```bash
    docker tag ubuntu:latest rg.fr-par.scw.cloud/mynamespace/ubuntu:latest
    ```
4. Push the image to your Container Registry namespace using docker:
    ```bash
    docker push rg.fr-par.scw.cloud/mynamespace/ubuntu:latest
    ```

<Message type="important">
  Replace `mynamespace` in the examples above with the name of your namespace.
</Message>