Custom Domain Names - DNS setup guide

You can use your own domain or subdomain with your LNbits SaaS instance.

This is useful if you want a branded payment URL for your shop, event, organisation, or public-facing LNbits deployment.

Go to your domain registrar control panel and open your domain name’s DNS records page

DNS Setup

Root Domain Configuration

Example configuration for example.com

Create a DNS record with the following settings

Type Host / Name Value / Points to TTL
A @ 68.183.254.12 Auto / 300 sec
CNAME www @ Auto / 300 sec

Subdomain Configuration

Example configuration for pay.example.com

Create a DNS entry with the following values

Type Host / Name Value / Points to TTL
CNAME pay api.lnbits.com Auto / 300 sec

This means visitors using pay.example.com will reach your LNbits instance.

After DNS is Added

Once the DNS record is live:

  1. Add the domain inside your LNbits SaaS settings
  2. Wait for DNS propagation this can take 5 minutes to a day depending on your record’s TTL settings
  3. SSL certificates are issued automatically once your domain resolves