By default, all Functions are assigned a unique URL, which is a subdomain of lagon.dev, pointing to the current production Deployment. The subdomain is always the name of the Function: if your Function is named my-function, your unique URL will be my-function.lagon.dev.

All domains (default and custom) are automatically assigned an SSL certificate, provided by Let's Encrypt (opens in a new tab). They are also automatically renewed before they expire. As such, the first request to a Function using a brand-new custom domain may take a few seconds to generate the SSL certificate.

All requests to your Function are automatically redirected to HTTPS.

Adding a domain

You can add custom domains or subdomains to your Functions, pointing to the current production Deployment. Head over to the settings tab of your Function, and scroll to the "Domains" section. Here, you can see a list including both the default domain and any custom domains or subdomains you've added:

To add a new custom domain or subdomain, click on "Add domain" button at the right, fill in the domain or subdomain and validate. Next, follow the instructions below to point your domain or subdomain to Lagon.

Pointing your domain to Lagon

Now that you've added a custom domain or subdomain, you must update the DNS settings of your domain to point to Lagon. You can do this by adding a CNAME record, pointing to your Function's default domain.

For a domain

Let's say that you have the following:

• A domain www.domain.com
• A Function named awesome-function (which has the default subdomain awesome-function.lagon.dev)

You should now add a new CNAME record named www, pointing to awesome-function.lagon.dev. After adding this record, go back to the settings tab of your Function, and you should now see your custom domain validated:

For a subdomain

Let's say that you have the following:

• A subdomain my.domain.com
• A Function named awesome-function (which has the default subdomain awesome-function.lagon.dev)

You should now add a new CNAME record named my, pointing to awesome-function.lagon.dev. After adding this record, go back to the settings tab of your Function, and you should now see your custom subdomain validated:

Removing a domain

To remove a custom domain or subdomain, click on the "Delete" button next to the domain name. You cannot remove the default subdomain.