#Unlimited preview environments

4 messages · Page 1 of 1 (latest)

full isle
#

Is it possible to setup using self hosting since i see theres a 120 limit on the professional plan

wise ingotBOT
#

Hi @full isle. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

#

There isn’t anything in the docs that explicitly says “unlimited preview environments,” but we can piece together what’s documented:

  • Cloud-hosted Convex has a deployment limit per team:
    • Free/Starter: 40 deployments
    • Professional: 120 deployments [Limits]
  • That limit applies to all deployments for the team (production, dev, and preview). Preview deployments “count towards your deployment limit.” [Preview limits]

So on the hosted product, you can’t exceed that 120‑deployment cap on Professional; preview deployments are included in that count.

For self‑hosting:

  • Self‑hosted Convex is the same open‑source backend the cloud uses, but run on your own infra. [Self hosting; Self‑hosted README]
  • When you self‑host, you interact with it via CONVEX_SELF_HOSTED_URL and CONVEX_SELF_HOSTED_ADMIN_KEY instead of CONVEX_DEPLOY_KEY, and you can deploy from CI/hosting providers like Vercel/Netlify against that backend. [Self‑host dev workflow]
  • The docs do not state any Convex‑imposed limit on how many self‑hosted backends or “deployments” you can run; you’re effectively constrained by your own infrastructure, not the Convex cloud team/deployment quotas.
#

However, there’s no explicit description of a “self‑hosted preview deployments” feature equivalent to the cloud preview‑deployment integration (automatic per‑branch backends, auto cleanup, etc.). The preview‑deployment docs and the CONVEX_DEPLOY_KEY‑based flow are written for the cloud service. [Vercel previews; Preview deployments]

So, based on the docs:

  • Cloud Convex: preview deployments are limited by the team deployment cap (40 / 120).
  • Self‑hosted Convex: you can run as many separate self‑hosted backends as your infra allows, but the docs don’t describe an out‑of‑the‑box “unlimited preview environments” feature; you’d be responsible for provisioning/tearing down those instances and wiring your CI to them.

If you need many more than 120 previews and want them managed automatically, the knowledge sources don’t say whether Convex can raise that limit beyond Professional; they only mention that some limits can be lifted for Professional customers “on a case‑by‑case basis,” but that’s about concurrency, not deployments. [Limits]

So:

  • Yes, you can use self‑hosting to avoid the cloud deployment cap and spin up as many Convex instances as you like, but:
    • You won’t get the documented cloud preview‑deployment automation out of the box.
    • You’ll need to build your own preview‑environment orchestration around the self‑hosted backend.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: