Domains
Connect custom domains to Easel projects and manage DNS, HTTPS, and routing.
Every Easel project receives an Easel-provided URL. You can also connect custom domains such as example.com, www.example.com, or docs.example.com.
A custom domain gives users a stable address for your application while Easel manages how requests reach the project's current production deployment.
Domain concepts
A domain setup has several independent parts:
- Registration determines who owns the domain
- DNS tells clients where to send requests
- Project assignment tells Easel which project should receive the request
- TLS secures requests over HTTPS
- Deployment routing determines which deployment serves the request
Changing one part does not necessarily change the others. For example, assigning a domain to a project does not update DNS at your provider.
Supported domain types
| Type | Example | DNS record |
|---|---|---|
| Apex domain | example.com | A record to Easel edge IPs |
| Subdomain | www.example.com | CNAME to cname.easelusercontent.com |
| Nested subdomain | app.eu.example.com | CNAME to cname.easelusercontent.com |
Wildcard domains such as *.example.com are not supported. Add each hostname you need.
The exact record values appear when you add the domain in the dashboard.
How domain setup works
A typical setup follows this sequence:
- Add the domain to an Easel project
- Configure the DNS records shown by Easel
- Wait for Easel to detect the records
- Allow Easel to provision a TLS certificate
- Test the domain over HTTPS
- Configure a canonical-domain redirect when needed
Adding a domain does not create a new deployment. The domain routes to the project's current production deployment.
Guides in this section
Add a custom domain
Add an apex domain or subdomain to a project.
DNS configuration
Configure apex and subdomain records.
Domain verification
How Easel confirms DNS points at the platform.
HTTPS and TLS
Certificate provisioning and renewal for custom domains.
Domain redirects
Redirect alternate hostnames to a canonical domain.
Wildcard domains
Current support status for wildcard hostnames.
Migrate a domain
Move an active domain to Easel.
Remove or move a domain
Detach a domain or assign it elsewhere.
Troubleshooting
Diagnose DNS, TLS, redirect, and routing problems.
Reference
Statuses, terminology, and limits.
Domains and deployments
Custom domains belong to projects, not individual deployment artifacts. They follow whichever Production deployment is current.
See Domains and deployments for production assignment, promotion, rollback, and domain-routing behavior.