T

Convex Community•8mo ago•

15 replies

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 devpnpx 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 devpnpx 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.logconvex-local-backend.log (via the CONVEX_TRACE_FILECONVEX_TRACE_FILE env var):

[2m2025-05-21T20:39:47.541027Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Starting a Convex backend
[2m2025-05-21T20:39:47.541060Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m 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.
[2m2025-05-21T20:39:47.545457Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Sentry is enabled. Errors will be reported to project with ID 6390839
[2m2025-05-21T20:39:47.547918Z[0m [32m INFO[0m [2mlocal_backend::persistence[0m[2m:[0m Connected to SQLite at /home/tpetrov/.convex/anonymous-convex-backend-state/anonymous-jairus/convex_local_backend.sqlite3
[2m2025-05-21T20:39:47.547988Z[0m [32m INFO[0m [2msearch::searcher::searcher[0m[2m:[0m Searchlight starting, local_storage_path: /tmp/.tmpRD3XBA max_size: 500.0 MiB

[2m2025-05-21T20:39:47.541027Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Starting a Convex backend
[2m2025-05-21T20:39:47.541060Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m 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.
[2m2025-05-21T20:39:47.545457Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Sentry is enabled. Errors will be reported to project with ID 6390839
[2m2025-05-21T20:39:47.547918Z[0m [32m INFO[0m [2mlocal_backend::persistence[0m[2m:[0m Connected to SQLite at /home/tpetrov/.convex/anonymous-convex-backend-state/anonymous-jairus/convex_local_backend.sqlite3
[2m2025-05-21T20:39:47.547988Z[0m [32m INFO[0m [2msearch::searcher::searcher[0m[2m:[0m Searchlight starting, local_storage_path: /tmp/.tmpRD3XBA max_size: 500.0 MiB

What I've tried
After deleting the ~/.convex~/.convex directory everything works fine. When it starts to fail after I import my data via pnpx convex import --path <path_to_backup>.zippnpx 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 Mibmax_size: 500.0 Mib be the issue?

Thank you to @Nipunn for his help so far!

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.

[2m2025-05-21T20:39:47.541027Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Starting a Convex backend
[2m2025-05-21T20:39:47.541060Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m 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.
[2m2025-05-21T20:39:47.545457Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Sentry is enabled. Errors will be reported to project with ID 6390839
[2m2025-05-21T20:39:47.547918Z[0m [32m INFO[0m [2mlocal_backend::persistence[0m[2m:[0m Connected to SQLite at /home/tpetrov/.convex/anonymous-convex-backend-state/anonymous-jairus/convex_local_backend.sqlite3
[2m2025-05-21T20:39:47.547988Z[0m [32m INFO[0m [2msearch::searcher::searcher[0m[2m:[0m Searchlight starting, local_storage_path: /tmp/.tmpRD3XBA max_size: 500.0 MiB

[2m2025-05-21T20:39:47.541027Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Starting a Convex backend
[2m2025-05-21T20:39:47.541060Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m 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.
[2m2025-05-21T20:39:47.545457Z[0m [32m INFO[0m [2mconvex_local_backend[0m[2m:[0m Sentry is enabled. Errors will be reported to project with ID 6390839
[2m2025-05-21T20:39:47.547918Z[0m [32m INFO[0m [2mlocal_backend::persistence[0m[2m:[0m Connected to SQLite at /home/tpetrov/.convex/anonymous-convex-backend-state/anonymous-jairus/convex_local_backend.sqlite3
[2m2025-05-21T20:39:47.547988Z[0m [32m INFO[0m [2msearch::searcher::searcher[0m[2m:[0m Searchlight starting, local_storage_path: /tmp/.tmpRD3XBA max_size: 500.0 MiB