Custom domains empower you to offer a tailored and branded experience for your users. Available only as an add-on for projects on the pro and enterprise plans, custom domains not only enhance your brand's visibility but also provide a more professional appearance compared to using Nhost's default domain.
You can configure Custom Domains for Auth, Hasura, PostgreSQL, and your own Run services using both the Nhost Dashboard or the Config file.
The following examples assume we are configuring custom domains at
Follow the instructions in the Custom Domain section of your project's settings:
- Add a CNAME record in your DNS provider for each of the services you want a custom domain for, and click "Verify". The verification might take a few seconds to succeed.
- Once the verification succeeds, click "Save" to update your project.
The first step is to add a CNAME record in your DNS provider for each of the services you want a custom domain for. You can find the instructions in the dashboard tab.
For Hasura, Auth, Functions, and PostgreSQL, custom domains are defined in the default
./nhost/config.toml as follows:
fqdn = ['hasura.custom-domain.com']
fqdn = ['auth.custom-domain.com']
fqdn = ['postgres.custom-domain.com']
fqdn = ['functions.custom-domain.com']
For Run services, typically in
nhost-service.toml specific to the service:
name = 'my-service'
image = 'docker.io/nhost/my-service'
port = 8080
publish = true
fqdn = ['my-service.custom-domain.com']