Hosting Requirements
Approved hosting providers and CNAME configuration guidelines.
DevSpace only supports CNAME records pointing to approved hosting providers. This ensures reliability, security, and consistent performance for all subdomains.
Approved CNAME Targets
The following hosting providers and their CNAME patterns are approved for DevSpace subdomains:
| Provider | CNAME Pattern | Example |
|---|---|---|
| GitHub Pages | *.github.io |
username.github.io |
| Vercel | *.vercel.app |
project.vercel.app |
| Netlify | *.netlify.app |
site.netlify.app |
| Cloudflare Pages | *.pages.dev |
project.pages.dev |
| Firebase Hosting | *.web.app |
project.web.app |
Only exact matches to the approved patterns are accepted. Custom domains, wildcard records, or CNAMEs pointing to other services will be rejected.
Provider-Specific Setup
GitHub Pages
To use GitHub Pages with your DevSpace subdomain:
- Go to your repository's Settings → Pages
- Under "Custom domain", enter your DevSpace subdomain (e.g.,
yourname.devspace.qzz.io) - Save the changes
- Wait for the DNS check to complete (may take a few minutes)
Your CNAME record value will be username.github.io where username
is your GitHub username.
Vercel
To configure a custom domain on Vercel:
- Go to your project dashboard on Vercel
- Navigate to Settings → Domains
- Add your DevSpace subdomain
- Select "CNAME" as the record type when prompted
Use cname.vercel-dns.com as your CNAME value, or the specific
deployment URL if using a project subdomain.
Netlify
To configure a custom domain on Netlify:
- Go to your site dashboard on Netlify
- Navigate to Domain settings → Add custom domain
- Enter your DevSpace subdomain
- Verify the domain
Your CNAME value will be your site's Netlify subdomain (e.g., yoursite.netlify.app).
Cloudflare Pages
To configure a custom domain on Cloudflare Pages:
- Go to your project on the Cloudflare dashboard
- Navigate to Custom domains
- Add your DevSpace subdomain
- Follow the verification steps
Your CNAME value will be your Pages subdomain (e.g., yourproject.pages.dev).
Firebase Hosting
To configure a custom domain on Firebase:
- Go to your Firebase project console
- Navigate to Hosting → Add custom domain
- Enter your DevSpace subdomain
- Follow the verification steps
Your CNAME value will be your Firebase app subdomain (e.g., yourapp.web.app).
What is Not Allowed
The following configurations are explicitly prohibited:
- A Records — IP address pointing is not supported
- MX Records — Email services are not permitted
- TXT Records — Verification records are not supported
- NS Records — Delegation to other nameservers is not allowed
- Custom Servers — Self-hosted or VPS servers are not approved
- Reverse Proxies — CDN or proxy configurations are not permitted
- URL Shorteners — Redirect-only services are not allowed
These restrictions are in place to maintain the integrity and security of the DevSpace registry. No exceptions will be made for individual requests.
SSL/TLS Certificates
All approved hosting providers automatically provision SSL/TLS certificates for custom domains. Once your subdomain is active and configured on your hosting platform, HTTPS will be available within a few minutes to a few hours.
If you experience SSL issues:
- Ensure your custom domain is properly configured on your hosting platform
- Wait at least 24 hours for certificate provisioning
- Check your hosting provider's documentation for troubleshooting steps