Setting custom domain

How to set and use your own domain

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!

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

  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.

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