CLI: Local development stack
Run the whole Sovaria stack on your machine with sov start: API, auth, SQL, storage, mail, optional functions, realtime and console, with well-known local keys, migrations, seed data and a .env.local.
sov start needs Docker. Every port is published on 127.0.0.1 only, and the keys it prints work only against this stack. Guide: Local development.
sov start --with forge,console
sov status
sov db reset --local # empty the local database, re-apply migrations + seed
sov stop # data kept; sov stop --reset deletes it#sov start
Start the local Sovaria stack (Docker): API, auth, SQL, storage, mail + bootstrap
sov start
Start the local Sovaria stack (Docker): API, auth, SQL, storage, mail + bootstrap
sov start [OPTIONS]Arguments and options
--withtextoptional- Extra services: forge (functions), pulse (realtime), atlas-doc (documents), sovariq (AI agent), console
--from-snapshotfileoptional- Recreate tables, policies and rows from
sov simulate snapshot --project-nametextoptional- Local project name (default: local)
--image-namespacetextoptional- Registry namespace of the sovaria-local-* images (default: SOVARIA_LOCAL_IMAGE_NAMESPACE or sovaria)
--no-pullflagoptional- Use images already on this machine
--no-migrationsflagoptional- Don't apply sovaria/migrations
--no-seedflagoptional- Don't run sovaria/seed.sql
--no-env-fileflagoptional- Don't write .env.local
--timeoutfloat rangeoptionaldefault300- Seconds to wait for health
sov start # core stack + project, keys, migrations, seed, .env.local
sov start --with forge,pulse,console # plus functions, realtime and the local console
sov start --from-snapshot snapshot.json # plus tables, policies and rows from `sov simulate snapshot`#sov stop
Stop the local stack (--reset deletes its data)
sov stop
Stop the local stack (--reset deletes its data)
sov stop [OPTIONS]Arguments and options
--resetflagoptional- Also delete the local database, storage and logs (volumes)
--yes / -yflagoptional- Don't ask before --reset
sov stop # keeps the data
sov stop --reset # deletes the local database, storage and logs#sov status
URLs, keys and health of the local stack
sov status
URLs, keys and health of the local stack
sov status
sov --json status | jq -r .keys.anon