🚧 Expanding soon — full Self-Hosting documentation is in progress.
BossMode is local-first
BossMode was designed local-first from day one. The cloud at bossmode.ing is a convenience layer — the full operational system can run entirely on your own machine or private server.
What you can self-host
Architecture overview
A self-hosted BossMode installation consists of:
- The CLI —
@bossmode/cli — runs on your machine
- The SQLite brain — local database seeded by
bossmode init
- The Convex backend — handles data sync, functions, and the multi-device layer
- The Next.js app — the cockpit UI, optionally hosted on your own server
For most self-hosters, the practical setup is:
- CLI and SQLite on your local machine
- Convex deployed to your own Convex instance (free tier available)
- Next.js app on Vercel, Fly.io, or your own server
Minimum viable self-host
The simplest self-host is just the CLI with local SQLite:
This gives you the full consigliere capability without any cloud dependency. The Daily Report is generated locally and available via bossmode report.
See also
