CustomDomain docs
Providers

Connect a DNSimple domain

Put a custom domain from DNSimple on your app with automatic HTTPS. One-click (OAuth) setup, the exact DNS records, and how to verify it went live.

Connect a DNSimple domain

Setup type: One-click (OAuth). You sign in to DNSimple in a popup and approve the change. No records to copy; no password is shared with the app.

DNSimple supports native OAuth, so you sign in to DNSimple, approve, and the records are added automatically. DNSimple is a developer-friendly registrar, and the connect flow leans on its native OAuth rather than asking you for an API token.

What you'll need

  • A domain whose DNS is managed at DNSimple.
  • Access to your app's CustomDomain dashboard (it shows the exact target for your account).

The records

CustomDomain gives you the authoritative records for your account in the dashboard, typically a CNAME (or apex A/ALIAS) pointing your domain at the edge. Use the values shown there; the shape is always the same, the target is per-account. There is no separate ownership TXT to add on this path: control is proven by the rail itself, or by the records appearing in your own authoritative DNS. See Setup types.

Setting it up on DNSimple

  1. In the connect widget, choose DNSimple and click connect.
  2. A DNSimple sign-in window opens. Approve the requested DNS change.
  3. The records apply automatically; you're returned to the app, which verifies and goes live.

DNSimple specifics

  • DNSimple's OAuth tokens are account-scoped, there are no granular per-action scopes to request, so the authorization screen reflects account-level access by design.

How you know it worked

CustomDomain polls public DNS and issues the TLS certificate automatically. When the dashboard shows the domain live, HTTPS is serving. Drift monitoring then watches the records so a later change at the provider doesn't silently break the domain.

FAQ

Is a copy-paste fallback available?

Yes. If you'd rather not use OAuth, CustomDomain always shows the exact records so you can add them in the DNSimple dashboard by hand and verify.

On this page