Install
Get started
Local development setup. You need a long auth secret and a strong first-boot admin password.
1. Prerequisites
- Install mise.
2. Clone the repo
git clone https://github.com/kkir/stomatopod.git cd stomatopod
3. Configure
mise install mise run config:init # Set auth.secret_key in stomatopod.toml, or: export STOMATOPOD_AUTH__SECRET_KEY="$(openssl rand -hex 32)" export STOMATOPOD_ADMIN_PASSWORD="$(openssl rand -base64 24)" # optional: export STOMATOPOD_ADMIN_EMAIL="you@example.com"
4. Run
mise run dev # Dashboard SSR at http://localhost:8080 # JSON API at /api/v1
Seed demo traffic with mise run seed while the server is up.
5. Production
Use Docker Compose or the published image. Mount a volume at /app/data so events survive restarts.