CLI shows "Checking that documents match your schema... See progress here: <url> "
schema validation hangs at 0% on the dashboard
this goes on indefinitely
#currently unable to deploy to production
swift tendon
warm belfryBOT
Hi @swift tendon. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:
When schema validation hangs at 0% during deployment and the dashboard shows no progress, this typically indicates an issue with the schema validation process or the underlying deployment state. Based on the knowledge sources, here are some possible causes and steps you can take:
-
Schema/Data Mismatch: Convex enforces that all existing documents must match the schema when you push changes. If there are documents that do not match the new schema, the push will fail or hang. Double-check that your schema changes are compatible with all existing data. For example, adding a required field to a table with existing documents that lack that field will cause validation to fail or hang. Consider making new fields optional first, updating all documents, and then making them required if needed Deploying Your App to Production.
-
Stuck Deployment/Cloud Issue: There have been reports of deployments or schema pushes hanging due to issues on the Convex cloud side. Sometimes, the dashboard or CLI can get stuck in a "code push in progress" state, especially if a previous push failed or the deployment is in a bad state. In such cases, waiting or retrying later may help, but if the issue persists, you may need to contact Convex support, especially if you are a Pro plan customer Discord: JavaScript execution ran out of memory, Discord: Convex is locked after trying to clear table.
-
Network Issues: Sometimes, network problems can cause schema validation or deployment to hang. Try running
npx convex network-testto check for connectivity issues. If you see failures, try a different network or check for VPN/firewall issues Discord: Network issue: can't connect with Convex. -
CLI Troubleshooting: You can try running the deploy command with verbose logging to get more information:
npx convex deploy --verboseThis may provide additional clues about where the process is getting stuck Discord: My Convex deployments are consistently timing out, Discord: stuck on npx convex deploy.
-
Last Resort: If your dev environment is locked or stuck, and you cannot resolve it, creating a new project/deployment may be necessary. This has resolved similar issues for other users Discord: Convex is locked after trying to clear table.
If none of these steps resolve the issue, and especially if you are a Pro plan customer, you should contact Convex support via the dashboard or at [email protected] for further assistance.