How to build and push a container image

Reviewed on October 21, 2025

This page explains how to create a simple Dockerfile to containerize your applications for deployment using Scaleway Serverless Containers.

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
Installed Docker engine or the Docker daemon locally
Created a Scaleway Registry namespace
A valid API key

In a new folder, create a file named Dockerfile.
Add the following content to your Dockerfile, adjusting the base image and commands according to your application:

Open a terminal and navigate to the directory containing your Dockerfile.
Run the following command to build your Docker image:
```
docker build -t my-application .
```
Note
Make sure to add the --platform linux/amd64 argument if you build your image on an ARM64 machine, as Serverless Containers only handle amd64 images.
Run the command below to log in to your Scaleway account in the terminal. Make sure that you replace the placeholder values with your own:
```
docker login rg.fr-par.scw.cloud/your-container-registry-namespace -u nologin --password-stdin <<< "$SCW_SECRET_KEY"
```

Tag your Docker image so it matches your Scaleway registry's format:

docker tag my-application:latest rg.fr-par.scw.cloud/your-container-registry-namespace/my-application:latest

Push the Docker image to the Scaleway Container Registry:

docker push rg.fr-par.scw.cloud/your-container-registry-namespace/my-application:latest

You can now access your container image from the Scaleway Container Registry, and deploy a Serverless Container from this image.

Tip

You can build, tag and push your image to your Container Registry in a single command using the following syntax:

docker build \
  --platform linux/amd64 \
  --push \
  -t your-container-registry-endpoint/my-application:latest .