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

How to Write a Dockerfile

Create a file named Dockerfile in your project directory.
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 --platform linux/amd64 -t my-application .
```
Note
Make sure to add the --platform linux/amd64 argument if you build your image on an ARM64 machine, as Serverless Jobs 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 Job 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 .