---
title: How to deploy a container
description: Deploy containers from the Scaleway Container Registry or from external public registries.
tags: deploy container create scaleway-registry docker image external registry public
dates:
  validation: 2026-01-29
  posted: 2021-05-26
---
import Requirements from '@macros/iam/requirements.mdx'
import ContainerRegistryNote from '@macros/serverless/container-registry-note.mdx'
import ContainerResources from '@macros/serverless/container-resources.mdx'
import ContainerAdvancedOptions from '@macros/serverless/container-advanced-options.mdx'

This page shows you how to deploy Serverless Containers using the [Scaleway console](https://console.scaleway.com/).

You can deploy a container from the [Scaleway Container Registry](/container-registry/quickstart/), or any other public container registry, such as Docker Hub, AWS Container registries, GitLab container registry, etc.

<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
- [Created a containers namespace](/serverless-containers/how-to/create-manage-delete-containers-namespace/)
- [Created a Container Registry namespace](/container-registry/how-to/create-namespace/) and [pushed a container image](/container-registry/how-to/push-images/) to it

## Deploy from the Scaleway Container Registry

1. Click **Containers** in the **Serverless** section of the side menu. The containers page displays.
2. Click the relevant container's namespace.
3. Click **Deploy container**. The container creation wizard displays.

### Container image configuration

1. Select the **Scaleway** Container Registry.

2. Select the required Container Registry region and namespace from the drop-down lists.

3. Choose an [image](/serverless-containers/concepts/#container-image) from your Container Registry, then select the container and tag.

4. Choose the [port](/serverless-containers/concepts/#port) your container is listening on. We recommend configuring your container to listen on the `$PORT` environment variable.

5. Choose a **name** for your container and, optionally, a **description**. The name must only contain alphanumeric characters and dashes.

### Container resources and scaling
<ContainerResources />

### Container advanced options
<ContainerAdvancedOptions />

### Container cost and validation

1. Update the **Number of requests** and **Average request duration** fields to simulate the behavior of your container.

2. Verify the **estimated cost**. Refer to the [Serverless Containers pricing](/serverless-containers/faq/#how-am-i-billed-for-serverless-containers) for more information on how billing works.

3. Click **Deploy container** to finish.

## Deploy from an external container registry

Scaleway Serverless Containers allows you to deploy containers from external public [container registries](/container-registry/concepts/#registry), such as Docker Hub, AWS container registries, GitLab container registry, etc.

Private external container registries are currently not supported.

<Message type="important">
<ContainerRegistryNote />
</Message>

1. Click **Containers** in the **Serverless** section of the side menu. The containers page displays.
2. Click the relevant container's namespace.
3. Click **Deploy container**. The container creation wizard displays.

### Container image configuration

1. Select the **External** Container Registry.

2. Enter the public container **image URL** provided by the external registry. For example:
      - `nginx:latest` to deploy the latest nginx image from [Docker Hub](https://hub.docker.com/)
      - `ghcr.io/namespace/image` to deploy an image from [GitHub Container Registry](https://github.com/features/packages)
3. Choose the [port](/serverless-containers/concepts/#port) your container is listening on. We recommend configuring your container to listen on the `$PORT` environment variable.

4. Enter a **name** for your container, or use the automatically generated one.

5. Optionally, add a **description** and **tags**.

### Container resources and scaling
<ContainerResources />

### Container advanced options
<ContainerAdvancedOptions />
  
6. Verify the **estimated cost**.
7. Click **Deploy container** to finish.

## Deploy a quickstart image

Scaleway Serverless Containers allows for a simple quickstart deployment with a new default image.

1. Click **Containers** in the **Serverless** section of the side menu. The containers page displays.
2. Click the relevant container's namespace.
3. Click **Deploy container**. The container creation wizard displays.

### Container image configuration

1. Select the **Quickstart image** container type.
2. Enter a **name** for your container, or use the automatically generated one.
3. Optionally, add a **description** and **tags**.

  ### Container resources and scaling
  <ContainerResources />

  ### Container advanced options
  <ContainerAdvancedOptions />
  
4. Verify the **estimated cost**.
5. Click **Deploy container** to finish.