Custom Domains
Custom Domains
Every Lumbox project gets a *.lumbox.eu subdomain by default. You can also bring your own domain — TLS is provisioned automatically via Let’s Encrypt.
Add a domain
lumbox domains add yourdomain.com
The CLI prints the DNS records you need to create.
Configure DNS
Create the following records at your DNS registrar:
| Type | Name | Value |
|---|---|---|
CNAME | @ (or www) | edge.lumbox.eu |
TXT | _lumbox-verify | <verification token> |
Apex domains (
@): Some registrars don’t support CNAME at the root. Use an ALIAS or ANAME record instead, or create an A record pointing to the IP shown inlumbox domains list.
TLS certificate
Once DNS propagates (usually under 5 minutes), Lumbox provisions a TLS certificate automatically. You don’t need to manage cert renewals — they happen transparently.
Check status:
lumbox domains list
A ✓ Active status means your domain is live and TLS is working.
Wildcard domains
Wildcard domains (e.g. *.yourdomain.com) are supported on Pro and Team plans:
lumbox domains add "*.yourdomain.com"
You’ll need to add a wildcard DNS record and a _acme-challenge TXT record for wildcard TLS validation.
Remove a domain
lumbox domains remove yourdomain.com
Troubleshooting
Certificate not provisioning: verify the _lumbox-verify TXT record is present and DNS has propagated (dig TXT _lumbox-verify.yourdomain.com).
Redirecting apex → www: set your registrar’s apex record to point to edge.lumbox.eu and use lumbox domains add www.yourdomain.com as the primary.