Custom Domain #

By default your server is reachable at <subdomain>.meldry.com. You can also point your own domain at it.

1. Add the domain in the dashboard #

  1. Open Settings → Server → Custom Domain.
  2. Enter your domain (for example chat.example.com).
  3. The dashboard shows you the DNS records you need to add.

2. Add the DNS records #

TypeNameValue
CNAMEchat.example.com<subdomain>.meldry.com
TXT_palpo-verify.chat.example.comthe token shown in the dashboard

DNS propagation can take up to 48 hours, but is usually much faster.

3. Wait for verification #

The dashboard polls DNS automatically. You will see two checks turn green:

  • CNAME OK — your domain points at the correct target
  • TXT OK — the verification token has been found

Once both checks pass, Meldry issues a TLS certificate via Let's Encrypt and starts serving your homeserver at the new domain.

Removing a custom domain #

Click Remove Custom Domain in the dashboard to revert to the default subdomain. Existing rooms and accounts are preserved — only the homeserver URL changes back.

Troubleshooting #

  • CNAME not detected — make sure your DNS provider has actually propagated the change. dig CNAME chat.example.com +short should return <subdomain>.meldry.com.
  • TXT not detected — check you set the host to _palpo-verify.<your domain> and not the apex.
  • Plan limit reached — custom domains are limited per plan. Upgrade or remove an existing one.