Dev deployment CONVEX_SITE_URL locked to custom domain (override disabled) - how to use native .com
❔Advice
Scope
I can’t change
Stack / versions
- Language: TypeScript
- Frontend: Nuxt
- Convex:
-
-
- Node:
- pnpm:
What I’m seeing
In Deployment Settings -> Custom Domains / Override Environment Variables:
-
- the combobox is disabled, so I can’t switch back to native
Repro steps
1. Have custom domains configured for production (
2. Open dev deployment settings.
3. Try to change
4. Control is disabled; value stays
Impact
- Local dev on
- I can work around routing, but the deployment-level URL still leaks into auth issuer/JWT claims.
Question
Is this expected behavior (dev
If yes, what’s the recommended way to keep prod custom domains but run dev with native Convex URLs (
I can’t change
CONVEX_SITE_URLCONVEX_SITE_URL on my dev deployment (UI control is disabled), and it appears stuck on my custom domain (https://my-domain.comhttps://my-domain.com). I want localhost-first dev auth without using that domain.Stack / versions
- Language: TypeScript
- Frontend: Nuxt
^4.3.1^4.3.1 - Convex:
^1.31.7^1.31.7 (npx convex --versionnpx convex --version => 1.31.71.31.7) -
@convex-dev/better-auth@convex-dev/better-auth: ^0.10.10^0.10.10 -
better-authbetter-auth: ^1.4.18^1.4.18 - Node:
v22.15.0v22.15.0 - pnpm:
10.10.010.10.0What I’m seeing
In Deployment Settings -> Custom Domains / Override Environment Variables:
-
process.env.CONVEX_SITE_URLprocess.env.CONVEX_SITE_URL shows https://my-domain.com (default)https://my-domain.com (default)- the combobox is disabled, so I can’t switch back to native
.convex.site.convex.site for devRepro steps
1. Have custom domains configured for production (
api.my-domain.comapi.my-domain.com / site.my-domain.comsite.my-domain.com). 2. Open dev deployment settings.
3. Try to change
CONVEX_SITE_URLCONVEX_SITE_URL override in dashboard. 4. Control is disabled; value stays
https://my-domain.comhttps://my-domain.com.Impact
- Local dev on
http://localhost:3000http://localhost:3000 can hit auth CORS/issuer issues if dev points at the custom domain.- I can work around routing, but the deployment-level URL still leaks into auth issuer/JWT claims.
Question
Is this expected behavior (dev
CONVEX_SITE_URLCONVEX_SITE_URL being locked when prod custom domains exist)? If yes, what’s the recommended way to keep prod custom domains but run dev with native Convex URLs (
*.convex.cloud*.convex.cloud / *.convex.site*.convex.site)?
