Skip to main content
Lumbox

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:

TypeNameValue
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 in lumbox 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.

Next steps