Convex Domains

by get-convex2cfe645c87f9No license63 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 6 days ago

Point a domain you already own at your Convex app (DNS records, custom-domain attach, auth-origin rebind).

Instructions onlyDevOps & Cloud

AI-generated overview

Guides pointing a user's own domain at a Convex app via DNS records, custom-domain attach and auth-origin rebind.

What it does: Walks through identifying the Convex hosting or deployment target, creating the required CNAME or apex A/ALIAS plus TXT verification records, and attaching the domain as a Convex custom domain. It offers to run DNS changes through an already-authenticated provider CLI (Cloudflare, Route53, Google Cloud DNS, DigitalOcean, Vercel) or tells the user exactly which records to add at their registrar. If the app uses auth, it rebinds the auth origin environment variables and re-publishes, then verifies HTTPS serving and any apex-to-www redirect.
When to use it: Use when a user owns a domain and wants it to serve their Convex app instead of the default Convex host. Also relevant when DNS records must be created or verified, or when a domain change requires rebinding the auth origin so sign-in keeps working.
Requirements: Instructions only, no bundled scripts. Requires a Convex app with a published site host or deployment HTTP actions URL, and access to the user's DNS provider (registrar or an already-authenticated CLI such as flarectl, aws, gcloud, doctl or vercel). Network access is needed for DNS lookups and verification; registrar credentials must not be shared.

Set up a custom domain with your own provider

Walk the user's own registrar through pointing their domain at the Convex app: identify the target (hosting or deployment URL), create the DNS records, attach the custom domain, and rebind the auth origin if the app uses auth.

Workflow

Identify the target: the published site host (for *.convex.app static hosting) or the deployment's HTTP actions URL.
Detect an ALREADY-AUTHENTICATED DNS CLI for the user's provider and OFFER to create the records automatically: Cloudflare → flarectl dns create (note: wrangler itself doesn't manage DNS records) or the CF API via their token env; Route53 → aws route53 change-resource-record-sets; Google Cloud DNS → gcloud dns record-sets create; DigitalOcean → doctl compute domain records create; Vercel DNS → vercel dns add. Check auth read-only first (flarectl user info / aws sts get-caller-identity / doctl account get); show the exact commands and get a yes before running.
If no authed CLI (or the user declines), tell the user exactly which records to create at THEIR registrar: the CNAME (or A/ALIAS at the apex) plus the TXT verification record — with concrete host/value strings, not placeholders.
Attach the domain as a Convex custom domain (dashboard or CLI) and wait for verification; note DNS propagation can take minutes to hours. Verify records landed with dig +short.
If the app uses auth (passkeys/OAuth), rebind the auth origin (SITE_URL / RP_ID / ORIGIN env vars) to the new domain and re-deploy/re-publish.
Verify: the domain serves the app over HTTPS, including the apex → www redirect if configured.

Rules

Never ask for or handle registrar credentials. A CLI already authenticated on the user's machine is fine — the credential stays in the tool; never install a CLI or run its login/auth flow for this, and never echo tokens.
DNS changes on a live domain are user-visible: show the exact commands and confirm before running them; verify afterwards with dig.
Always include the TXT verification record, not just the CNAME.
Rebinding the domain changes the auth origin — re-publish after, or sign-in breaks.

Source and attribution

Source:get-convex/agent-skillsinskills/convex-domainsat commit2cfe645

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Convex Domains

Set up a custom domain with your own provider

Workflow

Rules

Source and attribution

More from get-convex/agent-skills

Convex Verify

Convex Test

Convex Suggest

Convex Sentinel

Convex Self Heal

Convex Seed

More in DevOps & Cloud

M5 Onboard

Spanner Basics

Secops Cases

Managed Airflow Migrations

Managed Airflow Dag Troubleshooting

Iam Helper For Privileged Access Management