Skip to main content

Add a Custom Domain

Every deployment gets a default Skysize address (for example my-shop.skysize.io). Add your own domain (for example erp.mycompany.com) to serve your production site under your own brand. Skysize provisions and renews the HTTPS certificate for you automatically.

note

Adding, editing, or removing domains requires the Admin role on the project. Custom domains are intended for production, staging and development keep their auto-generated *.skysize.io hostnames.

Step 1: Add the domain in Skysize​

  1. Open your project and go to the Branches tab.
  2. Select your production branch and open its Domains section.
  3. Enter your domain (e.g. erp.mycompany.com).
  4. Leave SSL enabled so Skysize obtains and renews an HTTPS certificate automatically (recommended).
  5. Add the domain.

You can add several domains to the same deployment; each appears in the Domains section with its own SSL status. When you add, change, or remove a domain on a running deployment, Skysize reconfigures the web routing and TLS automatically, no redeploy needed.

caution

You can't claim a domain under skysize.io as a custom domain, those hostnames are reserved and assigned by the platform.

Step 2: Point your DNS at Skysize​

At your DNS provider, create a CNAME record that points your domain to your deployment's default Skysize hostname:

TypeNameValue
CNAMEerpmy-shop.skysize.io

Replace my-shop.skysize.io with your project's production hostname.

:::tip Root/apex domains A CNAME can't sit on a bare root domain (mycompany.com). To use an apex domain, use your provider's apex-aliasing feature (often called ALIAS, ANAME, or CNAME flattening) pointing to your Skysize hostname, or simply use a subdomain such as erp. or www.. :::

Cloudflare proxy​

If your domain is managed through Cloudflare, you can route traffic through the Cloudflare proxy (the "orange cloud") for DDoS protection and CDN caching, controlled by the proxy toggle in the Domains section. Toggling it reconfigures the record immediately. On the free tier, deployments are always served through the proxy; the ability to turn it off is a paid-plan feature.

DNS changes usually propagate within minutes, but can take longer depending on your provider's TTL.

Step 3: Wait for the SSL certificate​

If you left SSL enabled, Skysize requests the HTTPS certificate automatically once your DNS points at the deployment, and renews it before it expires. Until the certificate is issued, the site may briefly be reachable over HTTP only.

Verify the domain is working​

Once DNS has propagated, open https://erp.mycompany.com in a browser, you should reach your Odoo login page.

If it doesn't work yet, check:

  • The domain is added to the production branch and saved.
  • The CNAME points to the correct Skysize hostname, verify with dig erp.mycompany.com or an online DNS lookup tool.
  • DNS propagation has completed (it can take a while after a change).
  • If HTTPS shows a certificate warning, the certificate may not be issued yet, give it a few minutes after DNS resolves, then retry.

For more on default domains and the Cloudflare proxy, see Domain Configuration.