statichost.eu logo
Documentation

Custom domains

In order to use your own domain for your site, you need to configure your site and add/change the necessary DNS records per the below instructions. If you follow this order for existing sites, you will have no down-time when switching to statichost.eu.

We have recently changed the managed domain for new teams to statichost.page. Existing teams and sites will continue to work using their original managed domain. See the “Domains” section in your site settings in the dashboard for details.

  1. Configure your domains in the dashboard, by navigating to your site and going to Settings where you will find Domains.

    Domain Settings

  2. Add DNS records for all of your domains to SITENAME.statichost.page. - these should be CNAME records for all domains except root domain(s) that need to use ALIAS.

    www.example.org.  CNAME  SITENAME.statichost.page.
    example.org.      ALIAS  SITENAME.statichost.page.
    

    Note the dot at the end of the domains. The dot is technically required. However, some DNS providers don’t let you add a trailing dot. In this case, you can leave it out, and it should work correctly.

When DNS settings have been updated and we receive the first request using your custom domain, we will create an HTTPS/SSL certificate for your site automatically and on-demand.

Root domains and IPv6

Root domains (e.g. example.org) cannot use CNAME records. If your DNS provider supports ALIAS or ANAME for the root domain, we recommend using that. It handles both IPv4 and IPv6 without further configuration. If ALIAS or ANAME is not available, then you should manually create A and AAAA records (for IPv4 and IPv6 respectively) pointing to our main server.

Recommended:

example.org.  ALIAS  SITENAME.statichost.page.

Alternative:

example.org.  A     95.217.26.94
example.org.  AAAA  2a01:4f9:c01f:8002::

We support IPv6 across our entire edge network. IPv6 works out of the box with domains that use CNAME, ALIAS or ANAME. This is because the SITENAME.statichost.page. domain that these records point to has both IPv4 and IPv6 set. The above ensures your root domain supports IPv4 and IPv6 as well, by using both A and AAAA if necessary.

Configuring domains via configuration file

It is no longer possible to configure domains via the statichost.yml configuration file. Any existing domain configuration there will be silently disregarded.