Docker Deployment

Quick Start

docker compose up -d --build

Open http://localhost:8765.

To stop:

docker compose down

What's included

The docker-compose.yml runs Strata in personal mode with:

• Frontend built and served by the backend
• Persistent notebook storage via a named volume
• Persistent cache and metadata via a named volume
• Health check on /health

Volumes

Volume	Mount point	Purpose
strata-state	/home/strata/.strata	Cache, metadata DB, artifacts
strata-notebooks	/tmp/strata-notebooks	Notebook directories

Data persists across docker compose down/up cycles. To reset completely:

docker compose down -v  # removes volumes

Environment variables

Override defaults in docker-compose.yml or via .env file:

environment:
  - STRATA_HOST=0.0.0.0
  - STRATA_PORT=8765
  - STRATA_DEPLOYMENT_MODE=personal
  - STRATA_CACHE_DIR=/home/strata/.strata/cache

See Configuration Reference for all options.

Building the image manually

docker build -t strata .
docker run --rm -p 8765:8765 \
  -v strata_state:/home/strata/.strata \
  strata

The multi-stage Dockerfile:

1. Frontend builder (Node 25) — builds the Vue.js UI
2. Backend builder (Python + Rust) — builds the wheel with native extension
3. Runtime — minimal image with the wheel and frontend dist