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

A custom domain is bound to a Git branch - Read more to understand the concepts behind.

Tutorial

1. Configuration

   Add to your .qovery.yml the following lines

   .qovery.yml

   ...
   routers:
   - name: main
     custom_domains:
     - branch: master
       domain: my.domain.tld
     routes:
     - application_name: simple-example-node-with-postgresql
       paths:
       - /

   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 master

2. Validation

   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 domains

   qovery domain list

   Output

   BRANCH | DOMAIN                                      | STATUS             | VALIDATION DOMAIN    | ROUTER NAME
   master | node.deimos.fr                              | validation pending | xxx-yyy-zzz.acme.com | main
   master | https://main-yenr7erjbs87dk4m-gtw.qovery.io | live               | none                 | main

   At this point, you need to add a CNAME record that is targeting the validation domain xxx-yyy-zzz.acme.com

   You need to go on the web interface provided by your domain provider and create new domain record of type CNAME

3. 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 domains

   qovery domain list

   Output

   BRANCH | DOMAIN                                      | STATUS | VALIDATION DOMAIN    | ROUTER NAME
   master | node.deimos.fr                              | live   | xxx-yyy-zzz.acme.com | main
   master | https://main-yenr7erjbs87dk4m-gtw.qovery.io | live   | none                 | main

   You’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.

How was it? Did this tutorial work?  Yes  No

As always, if you run into any trouble, find us on chat we’ll be glad to help out.