> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luxima.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom domain

> Publish passports on your own address, such as dpp.yourbrand.com.

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.

> [!NOTE]
>
> 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:

| Type | Name / host | Value / target | TTL |
| - | - | - | - |
| CNAME | The subdomain part, for example `dpp` | `passports.luxima.io` | Auto |

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](https://mintcdn.com/mbp-network-technology-limited/mP_qszweR2l6V8Qr/images/passports/custom-domain.png?fit=max\&auto=format\&n=mP_qszweR2l6V8Qr\&q=85\&s=6e9b5b6e9721b7717895100f43add890)

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:

| Step | Meaning |
| - | - |
| **Pending** | Your domain is saved. |
| **Certificate issued** | LUXIMA found the DNS record. |
| **Live** | Passports are open at your address. |

When it is live you see: "Passports are live at ... New QR codes, labels and exports use this address."

## What happens to existing links

* 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.

> [!WARNING]
>
> 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

| Message | What to do |
| - | - |
| "The DNS record was not found within 7 days." | Add the CNAME record, then remove the domain in LUXIMA and add it again. |
| "The certificate could not be issued." | Check the CNAME record, then remove the domain and add it again. If it keeps failing, contact support. |
| "The address no longer points to Luxima." | The DNS record was changed or deleted. Restore it. |
| "Use a subdomain, such as dpp.example.com" | Use an address like `dpp.yourbrand.com`, not `yourbrand.com`. |
| "This address is already in use." | Choose a different subdomain, or contact support if it is yours. |
| "Your organisation already has a domain." | Remove the current domain before adding another. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.