Domains

Qovery Domains (default)

Your application is publicly accessible via a Qovery domain as soon as you define it to be publicly accessible in .qovery.yml file:

application:
name: myapp
project: test
publicly_accessible: true

To get the domain that was assigned to your application, use the CLI:

$ qovery status
OUTPUT
BRANCHES NAME STATUS ENDPOINTS APPLICATIONS DATABASES BROKERS STORAGE
master up and running https://xxx-main-gtw.qovery.io 1 1 0 0
APPLICATIONS NAME STATUS ENDPOINTS DATABASES BROKERS STORAGE
simple-example up and running https://yyy-xxx-app.qovery.io 1 0 0

Custom Domains

You can use a custom domain name for any of your applications. Additionally, the domain name can be different in each environment (branch).

Set a domain

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

Adding the highlighted lines like in the configuration file above exposes your application using your domain. Now commit and push your changes.

Domain validation

To use you domain, you have to confirm that it is yours. Execute the command qovery domain list to list all domains of your environment:

List 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

Now, to validate a domain that is in validation pending status, add a CNAME record that is targeting the VALIDATION DOMAIN - xxx-yyy-zzz.acme.com. After doing so, it takes Qovery a few minutes to verify and complete the process. You can check the verification status using qovery domain list.