> ## 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.

# Self-Hosting Overview

> BossMode's MIT-licensed core can be self-hosted on your own infrastructure. Full control, local data, no cloud dependency.

<Warning>🚧 Expanding soon — full Self-Hosting documentation is in progress.</Warning>

## 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

| Component          | License            | Self-hostable                     |
| ------------------ | ------------------ | --------------------------------- |
| BossMode CLI       | MIT                | Yes                               |
| Local SQLite brain | MIT                | Yes                               |
| Convex backend     | Convex OSS license | Yes (via Convex self-host)        |
| Next.js app        | MIT                | Yes                               |
| AvatarCzar engine  | Proprietary        | Cloud-only (API access available) |
| MCP server         | MIT                | Yes                               |

## 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:

```bash theme={null}
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](/self-hosting/mit-core) — What's included in the MIT license
* [Local SQLite](/self-hosting/local-sqlite) — How the local brain is structured