What will you learn in this guide?
- ✓ Adding a custom domain to your project (e.g., example.com)
- ✓ Configuring DNS records (A and CNAME records)
- ✓ How automatic and free SSL certificates work
When you successfully deploy your project to Skyversal, the system automatically assigns a temporary domain (e.g., project-name.skyversal.com). However, you'll likely want to publish your application using your own domain.
1. Add Your Domain
After logging into the Skyversal dashboard, follow these steps:
1. Go to your project's page from the Dashboard.
2. Click on the Domains tab from the top menu.
3. In the Add Domain section, enter the domain you want to use (e.g., example.com).
4. Click the Add button.
2. Configure DNS Routing
After adding your domain, Skyversal will show you the required DNS records. You must go to the management panel of your domain provider (Cloudflare, GoDaddy, etc.) and enter these records:
DNS changes are usually completed within a few minutes, but depending on your registrar, it can take up to 24 hours to propagate globally.
When Cloudflare Proxy (Orange Cloud) is enabled, initial SSL verification may be delayed in some cases. It is recommended to set your domain to DNS Only (Grey Cloud) during the initial setup.
If you want to run your project on a subdomain like api.example.com, you only need to add a CNAME record in your DNS panel instead of an A record. The Host should be api, and the Value should be cname.skyversal.com.
3. Automatic SSL Certificate
As soon as Skyversal detects that you have successfully connected your custom domain, it generates a completely free SSL certificate (HTTPS) via Let's Encrypt and installs it on your server.
HTTPS is automatically enabled once the SSL certificate is generated.
When your SSL certificate is about to expire, Skyversal detects it and automatically renews it transparently in the background.
- Domain connected
- DNS verified
- SSL active
- HTTPS working
- HTTP → HTTPS redirect active
❓ Troubleshooting
I entered DNS records but my site isn't loading
DNS propagation globally can sometimes take between 1-2 minutes up to 24 hours. If you're using Cloudflare, you can speed up the SSL setup by temporarily setting the Cloudflare proxy to DNS Only (Grey Cloud) instead of Proxied (Orange Cloud) initially.
I get an SSL issuance error
This error occurs when your DNS records do not yet point to Skyversal servers. For security, the system does not generate an SSL certificate until it confirms the domain is truly routed to us. Wait a little and try again.
Is HTTP → HTTPS redirection automatic?
Yes. The moment you add a domain to your project and an SSL certificate is generated, all incoming HTTP requests are automatically redirected to a secure HTTPS connection.
www and non-www redirection (Canonical Domain)
For Search Engine Optimization (SEO) purposes, it is important that your site operates from a single address. After adding both `www` (CNAME) and the root domain (A), you can select your primary domain from the Skyversal panel to redirect your application's main domain (e.g., non-www).
🚀 Everything is Ready!
You have successfully connected your domain and your SSL setup is complete. You can now securely open your project to your visitors.
In the next guide, you can learn how to manage Environment Variables (.env).
➔ Environment Variables (.env)