Skip to content
CantelopBeta

Local development

cantelop dev runs your Edge API and Session runtime at 127.0.0.1:8787, without an account or login.

Terminal
$ cantelop dev
  • Native mode runs each active Session in a Bun subprocess and rebuilds after edits. Updated Session code takes effect in a new subprocess on the next message.
  • Container mode (cantelop dev --container) runs Sessions in Docker to check custom images, native dependencies, and Linux filesystem behavior. It uses the same managed user and /workspace working directory as production.
  • App behavior includes Session routing, ordered messages, cancellation, keep-alive, SSE, and output-only WebSocket streams.
  • Environment and files use defaults from cantelop.json plus .env overrides. Workspace files persist under .cantelop/dev/workspaces/ across rebuilds and restarts.

Limitations#

  • Native mode does not use your Docker image or emulate Linux and /workspace. Container mode requires Docker and must be restarted after source changes.
  • The API runs in a Node.js Web API host. Local mode does not reproduce Cloudflare workerd, Firecracker isolation, production networking, or distributed recovery.
  • Pending messages and event replay are in-memory and lost when the development runner restarts. Persistent Workspace files do not preserve running work.

Run cantelop build to validate the complete Linux release build without uploading it. See the quick start for setup and the CLI reference for command options.