Custom domains

TXT verification, then CNAME (or A records on an apex)

Ask your agent

Put my app on my own web address.Read the guide at percher.app/docs/custom-domains

My own web address isn't working yet. Help me sort it out.Read the guide at percher.app/docs/custom-domains

How it works, with exact details

Every app gets a name.percher.run subdomain. You can also add your own domain:

# Add a domain
bunx percher domains add app.myapp.com

# Percher returns DNS instructions for that exact name:
# 1. Add TXT record: _percher-challenge.app.myapp.com -> percher-domain-verification=<token>
# 2. Add CNAME: app.myapp.com → your-app.percher.run

# Verify (after DNS propagation)
bunx percher domains verify app.myapp.com

# List / remove
bunx percher domains list
bunx percher domains remove app.myapp.com

# SSL is provisioned automatically via Let's Encrypt.

Root domain?

For an apex like myapp.com Percher returns A records pointing at the platform IPs instead of a CNAME — most DNS providers reject a CNAME on the root. If yours supports CNAME flattening or ALIAS, that's offered as an alternative. Follow whichever records the command prints.

Custom domains are a paid feature — per app: Starter 2, Maker 5, Max 10. Free apps stay on name.percher.run.