Run these commands from an existing Lucim checkout. You need Docker with Compose, Node.js, and the development secret values required for the flows you intend to exercise.

​
Start the stack

1

Prepare local environment files

Create backend/.env and frontend/.env if they do not exist. The start script creates minimal local files, but authenticated and provider-backed flows require the matching development credentials.
2

Build and start

For later starts without a rebuild:
3

Check services

  • Frontend: http://localhost:5173
  • API: http://localhost:8000
  • API docs in debug mode: http://localhost:8000/api/docs
  • Hosted MCP: http://localhost:8001/mcp
  • Postgres: localhost:55432
  • Redis: localhost:56379
  • Vault: http://localhost:8200
  • MinIO API/UI: localhost:59000 and localhost:59001

​
Logs and shutdown

./scripts/dev-stop.sh --volumes deletes local database and object-storage state. Use it only when you intend to reset the environment.

​
Optional sandbox profile

The sandbox profile still requires its development conformance and credential setup.