Skip to main content
With a custom domain, your passports open at an address on your own domain instead of app.luxima.io. Your address shows only your own passports.
Custom domains are part of the Growth and Enterprise plans. Only an organisation admin can add one. Each company can have one domain.

Before you start

You need access to the DNS settings for your domain. This is usually at the company where you registered it, or at a service such as Cloudflare. If someone else manages your website, send them this page. The address must be a subdomain, such as dpp.yourbrand.com. A bare domain such as yourbrand.com cannot be used.

Set it up

1

Add your domain in LUXIMA

Open Settings, then Domain. Type the address in Your passport domain, for example dpp.yourbrand.com, and click Add domain.
2

Add the DNS record

LUXIMA shows the record to create. At your DNS provider, add a CNAME record with the values shown:Use the values shown on your own page.
The Domain tab in Settings showing the passport domain with a Remove domain button, the CNAME record to add, a Check again button, a status row with Pending done and Certificate issued and Live still waiting, and a warning about QR codes printed with your own address

The Domain page after adding a domain, waiting for the DNS record

If your DNS is on Cloudflare, set the record to “DNS only” (the grey cloud).
3

Wait for it to go live

LUXIMA checks for the record every few minutes and issues a security certificate automatically, so your passports are served over HTTPS. Click Check again to check straight away.

Status

The status card shows three steps: When it is live you see: “Passports are live at … New QR codes, labels and exports use this address.”
  • Every passport stays available on the LUXIMA address as well. QR codes you already printed keep working.
  • New QR codes, labels and exports use your own address while the domain is live.
QR codes printed with your own address work only while the DNS record stays in place. If you remove the record or the domain, those codes stop opening. Codes printed with the LUXIMA address keep working either way.

Remove the domain

Open Settings, then Domain, and click Remove domain. It takes effect straight away, and new links go back to the LUXIMA address.

If setup fails