Skip to main content

Pip + SQLite

pip install z4j, then z4j serve. Zero containers, zero infra.

The lightest deployment tier: a single PyPI install with SQLite as the data store. No Postgres, no Docker daemon, no Kubernetes. Right for a homelab Raspberry Pi, a single-developer laptop, a CI worker, or a small team that just wants a working dashboard in five minutes. Same dashboard, same RBAC, same audit log as the production tiers.

Ships with

  • Pure Python install via pip; no Docker daemon required
  • SQLite by default, optional Postgres at any time without re-onboarding
  • First-boot setup wizard mints secrets and writes them to ~/.z4j/secret.env
  • 127.0.0.1 default bind keeps dev installs off the network
  • Identical feature set to the Docker tiers; nothing is gated to paid plans

Highlights

  • Five-minute install on any machine with Python 3.13+
  • Smart buffer-path fallback for service-user installs (gunicorn under www-data)
  • z4j doctor runs a connectivity ladder (DNS, TCP, TLS, WebSocket) for triage
Related

More capabilities