Skip to content
Nyxory Docs

Add a custom domain

Bind your own domain to a deployed app. The TLS cert is issued and renewed for you; you only touch DNS.

  1. Pick a hostname.

    Apex (example.com) or subdomain (app.example.com) — both work. If you’re attaching for the first time and you can choose, a subdomain is easier because it uses a CNAME rather than the ALIAS/ANAME records some registrars don’t support at the apex.

  2. Bind the domain to your app.

    Apps → <your app> → Domains → Add domain. Paste the hostname, click Add. The page shows the DNS target you need to point at next.

  3. Point your DNS at the returned target.

    The response gives you a target hostname (something like <cluster>.nyxory.app).

    • Subdomain: add a CNAME from your hostname to the target.
    • Apex: use ALIAS / ANAME / flattened CNAME at your registrar (Cloudflare, Route 53, DNSimple all support this).

  4. Wait for the cert.

    Terminal window
    nyx domain status example.com --watch

    Or refresh the console Domains tab. Typical first issuance: 2–5 minutes. The cert auto-renews thereafter — you don’t touch it again.

  5. Verify.

    Terminal window
    curl -I https://example.com

    Expect 200 OK and a valid Let’s Encrypt cert.

Listing + removing

Section titled “Listing + removing”
Terminal window
nyx domain list                       # all your bound domains
nyx domain list --app widget          # just one app
nyx domain remove example.com         # detach + revoke

Troubleshooting

Section titled “Troubleshooting”