Your app works on its temporary Coolify URL as soon as it deploys. When you are ready to use your own domain, configure DNS and add the domain in Coolify.
What you will need
- A deployed Coolify application.
- A domain name you control.
- Access to your domain registrar or DNS provider.
- Your MapleDeploy server IP address.
You can find the server IP in the MapleDeploy dashboard on the server details page, or in Coolify under Settings > Server.
Step 1: Add DNS records
At your DNS provider, create A records that point to your server IP.
| Type | Name | Value |
|---|---|---|
| A | example.com | Your server IP |
| A | www | Your server IP |
DNS changes often work within 10 to 30 minutes, but some providers can take longer.
Step 2: Add the domain in Coolify
Open your application in Coolify. In the General settings, find the Access section and select Manage Domains.
On the Domains page, select Add Domain. Leave the protocol set to https, enter your domain (for example example.com) and save. Coolify also adds the www version, which is why Step 1 includes a www record. For a subdomain such as app.example.com it adds www.app.example.com, so add a DNS record for that name too or remove it on the Domains page. After you save, Coolify checks DNS and flags any domain that does not point to your server yet.
Redeploy the application so the new domain takes effect.
Step 3: Verify SSL
After the deploy finishes, visit your domain in a browser.
Coolify issues an SSL certificate after DNS points to your server. If the certificate is not ready yet, wait a few minutes and try again.
Once the domain is working, the Links menu will show your production URLs.
Troubleshooting
The domain still points somewhere else: Check the A record at your DNS provider and confirm it points to your MapleDeploy server IP.
SSL is not issued yet: DNS must resolve to your server before the certificate can be issued. If you recently changed DNS, wait a few minutes and redeploy.
The app returns 502: The domain is reaching the server, but the application is not responding on the expected port. Confirm Ports Exposes matches the port your application listens on.