Randolph, son of Mandolph
Randolph, son of Mandolph•2w ago

Local backend fails to start

The Issue I'm having some issues with getting my Convex backend to start while running it locally. The pnpx convex dev command just times out after 10 seconds. The Setup I'm running Convex on Windows 11 inside of Arch linux using WSL 2 The Error Message pnpx convex dev: 
waiting for local backend to start...
✖ Local backend did not start on port 3210 within 10 seconds.
✖ Hit an error while running local deployment.
Your error has been reported to our team, and we'll be working on it.
To opt out, run `npx convex disable-local-deployments`. Then re-run your original command.
waiting for local backend to start...
✖ Local backend did not start on port 3210 within 10 seconds.
✖ Hit an error while running local deployment.
Your error has been reported to our team, and we'll be working on it.
To opt out, run `npx convex disable-local-deployments`. Then re-run your original command.
From convex-local-backend.log (via the CONVEX_TRACE_FILE env var): 
2025-05-21T20:39:47.541027Z  INFO convex_local_backend: Starting a Convex backend
2025-05-21T20:39:47.541060Z  INFO convex_local_backend: The self-host Convex backend will periodically communicate with a remote beacon server. This is to help Convex understand and improve the product. You can disable this telemetry by setting the --disable-beacon flag or the DISABLE_BEACON environment variable if you are self-hosting using the Docker image.
2025-05-21T20:39:47.545457Z  INFO convex_local_backend: Sentry is enabled. Errors will be reported to project with ID 6390839
2025-05-21T20:39:47.547918Z  INFO local_backend::persistence: Connected to SQLite at /home/tpetrov/.convex/anonymous-convex-backend-state/anonymous-jairus/convex_local_backend.sqlite3
2025-05-21T20:39:47.547988Z  INFO search::searcher::searcher: Searchlight starting, local_storage_path: /tmp/.tmpRD3XBA max_size: 500.0 MiB
2025-05-21T20:39:47.541027Z  INFO convex_local_backend: Starting a Convex backend
2025-05-21T20:39:47.541060Z  INFO convex_local_backend: The self-host Convex backend will periodically communicate with a remote beacon server. This is to help Convex understand and improve the product. You can disable this telemetry by setting the --disable-beacon flag or the DISABLE_BEACON environment variable if you are self-hosting using the Docker image.
2025-05-21T20:39:47.545457Z  INFO convex_local_backend: Sentry is enabled. Errors will be reported to project with ID 6390839
2025-05-21T20:39:47.547918Z  INFO local_backend::persistence: Connected to SQLite at /home/tpetrov/.convex/anonymous-convex-backend-state/anonymous-jairus/convex_local_backend.sqlite3
2025-05-21T20:39:47.547988Z  INFO search::searcher::searcher: Searchlight starting, local_storage_path: /tmp/.tmpRD3XBA max_size: 500.0 MiB
What I've tried After deleting the ~/.convex directory everything works fine. When it starts to fail after I import my data via pnpx convex import --path <path_to_backup>.zip. Questions I'm fairly certain that my DB is bigger than 500 Mib, so could that last line with the max_size: 500.0 Mib be the issue? Thank you to @Nipunn for his help so far!
5 Replies
Convex Bot
Convex Bot•2w ago
Thanks for posting in <#1088161997662724167>. Reminder: If you have a Convex Pro account, use the Convex Dashboard to file support tickets. - Provide context: What are you trying to achieve, what is the end-user interaction, what are you seeing? (full error message, command output, etc.) - Use search.convex.dev to search Docs, Stack, and Discord all at once. - Additionally, you can post your questions in the Convex Community's <#1228095053885476985> channel to receive a response from AI. - Avoid tagging staff unless specifically instructed. Thank you!
ari
ari•2w ago
The backend shouldn’t have a size limit, I suspect that log refers to the search feature within the backend I don’t know if anyone on the team has tested the local backend in WSL (yet), but it does work on Linux As a quick litmus test, could you try running the CLI on your Windows machine? And do you know if your WSL setup has any network configuration that might block access to ports?
Randolph, son of Mandolph
Randolph, son of MandolphOP•2w ago
That's a good idea to run it in Windows. I'll give that a shot The only port stuff I've done is added port forwarding for 3210 and 3211 via netsh so I can access them from my local network on another device I got the same error on Windows too after I imported my data. I would give you the backup for testing, but It has confidential customer data, so I can't. I also tried deleting every file in ~/.convex except for the sqlite db itself, and I was getting the same error. Let me know if there's anything else I could try
ari
ari•2w ago
Ok cool, that does lead me to believe it has something to do with the data then, and since you tried on window's it's not isolated to your WSL setup. This is a bit out of my depth (I mostly work on the Convex dashboard), but I'll try to get this in front of someone who knows more about how the local backend works No need to share your confidential data -- we'll try to recreate the situation Thanks for your patience and help with debugging!
Randolph, son of Mandolph
Randolph, son of MandolphOP•2w ago
Absolutely! Please reach out if you have any questions recreating the issue, and I'll let you know if I find any new info as well Also I was incorrect about the db size. The sqlite file is 296 MB (282 MiB), so not anywhere near the limit of the search feature (or whatever it is)

Did you find this page helpful?