Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bossmode.ing/llms.txt

Use this file to discover all available pages before exploring further.

🚧 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

ComponentLicenseSelf-hostable
BossMode CLIMITYes
Local SQLite brainMITYes
Convex backendConvex OSS licenseYes (via Convex self-host)
Next.js appMITYes
AvatarCzar engineProprietaryCloud-only (API access available)
MCP serverMITYes

​
Architecture overview

A self-hosted BossMode installation consists of:
  1. The CLI — @bossmode/cli — runs on your machine
  2. The SQLite brain — local database seeded by bossmode init
  3. The Convex backend — handles data sync, functions, and the multi-device layer
  4. 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: 
npx @bossmode/cli init
# BossMode runs entirely locally, no network calls
This gives you the full consigliere capability without any cloud dependency. The Daily Report is generated locally and available via bossmode report.

​
See also

  • MIT Core — What’s included in the MIT license
  • Local SQLite — How the local brain is structured