Every application on Qovery automatically gets a free qovery.io
address which does not change per branch.
But you can also bring your own domains to Qovery easily. We handle TLS/SSL certificate creation and renewal, as well as automatic HTTP to HTTPS redirects for all your custom domains. Let’s learn how to set up your domains on Qovery!
Before you begin, this page assumes the following:
- You have installed the Qovery CLI
- You have a domain
- You have the permission to add a CNAME record to your domain
- You have deployed your application by using the
master
Git branch
Tutorial
Configuration
Add to your
.qovery.yml
the following lines.qovery.yml...routers:- name: maincustom_domains:- branch: masterdomain: my.domain.tldroutes:- application_name: simple-example-node-with-postgresqlpaths:- /Save the changes by committing and pushing your changes
$ git add .qovery.yml$ git commit -m "Add my custom domain into .qovery.yml"$ git push -u origin masterValidation
Qovery needs to validate that the domain is yours. To do it, you need to target a CNAME that we generate for your custom domain. Get the target CNAME by executing:
List all domainsqovery domain listOutputBRANCH | DOMAIN | STATUS | VALIDATION DOMAIN | ROUTER NAMEmaster | node.deimos.fr | validation pending | xxx-yyy-zzz.acme.com | mainmaster | https://main-yenr7erjbs87dk4m-gtw.qovery.io | live | none | mainAt this point, you need to add a CNAME record that is targeting the validation domain
xxx-yyy-zzz.acme.com
Ready
Once you’ve added your domain, it can take a few minutes to be verified on Qovery. You’ll see the domain verification status in green once everything is good to go.
List all domainsqovery domain listOutputBRANCH | DOMAIN | STATUS | VALIDATION DOMAIN | ROUTER NAMEmaster | node.deimos.fr | live | xxx-yyy-zzz.acme.com | mainmaster | https://main-yenr7erjbs87dk4m-gtw.qovery.io | live | none | mainYou’re all set! Your custom domains will start pointing to your application, and we’ll continue to issue and renew SSL certificates for them as long as you’re using Qovery.
As always, if you run into any trouble, find us on chat we’ll be glad to help out.