Suggest an edit

How to add a custom domain to a container

Reviewed on 27 March 2024Published on 21 February 2022

Each container comes with an automatically generated domain, on which it is available. However, it is possible to use your own domain name to address your containers to facilitate their use.

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 running Serverless Container

  • Registered a domain name with the provider of your choice and have access to the domain name’s DNS zone file

    If you are using Cloudflare DNS, see the note below regarding proxying.

  1. On your domain provider’s platform (for example, Scaleway’s domains), add a CNAME record pointing to your container default URL in the domain’s DNS zone file.

    • All domains are supported.

    • When using a root domain:

      • If available, CNAME flattening is mandatory. CNAME flattening speeds up CNAME resolution and allows you to use a CNAME record at your root/apex domain. For example, for Cloudflare, this will look like the following:
      • If your DNS provider does not support CNAME flattening, you need to create an ALIAS on your root domain (named @ or with an empty name) instead of a CNAME.
  2. Click the Endpoints tab on your containers’ page.

  3. Click + Add endpoint.

  4. Enter your custom domain name and validate the form.

  5. The console runs checks on the CNAME and TLS configuration of the custom domain name. Connect to your container using your custom domain once all checks are complete.


Custom Domains do not currently support websockets. If you need to use websockets, you must configure them with the original container URL.

See also
How to manage a containerHow to modify container privacy
Docs APIScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCarreer
© 2023-2024 – Scaleway