# Virtues

> Virtues is a home server that holds the data of your life — emails, messages, calendars, health, transactions, journals — under your roof, and the operating system that turns that data into self-knowledge. Open source, self-hosted, yours.

Every docs page is also available as plain markdown by appending `.md` to its URL. The full manual concatenated into one document is at https://virtues.com/llms-full.txt.

## Start here

- [What Virtues is](https://virtues.com/docs.md): Virtues is a server that holds the data of your life under your own roof, and the software that turns it into a readable record. Start here.

## Set up

- [What to run it on](https://virtues.com/docs/setup/requirements.md): The machine Virtues needs — OS, memory, disk, and the accelerator question. What actually decides whether it feels fast, and which corners are safe to cut.
- [Setting up inference](https://virtues.com/docs/inference.md): Virtues searches your record with two local models — an embedder and a reranker — that you run yourself. The contracts they must speak, the llama.cpp commands that serve them, which models work, and how to point the server at them.
- [Installing](https://virtues.com/docs/setup/install.md): Install Virtues OS on your own Linux machine with one command — what it needs, what it does, and how to audit it before you run it.

## Operate

- [Reaching your server](https://virtues.com/docs/operate/reach.md): How your phone and laptop connect to your Virtues server at home and away — pairing devices, what the relay can and cannot see, and what to expect when the network changes.
- [Upgrading](https://virtues.com/docs/operate/upgrading.md): How a Virtues server moves between releases — channels, the atomic upgrade, dry runs, and rollback.
- [Backup & restore](https://virtues.com/docs/operate/backup-and-restore.md): How to protect a Virtues server — minting the recovery key the server will never hold, backing up to a drive, verifying archives, and restoring.
- [When something breaks](https://virtues.com/docs/operate/recovery.md): Diagnosing a Virtues server that won't start, won't answer, or is behaving strangely — services, logs, health commands, and where everything lives.
- [The CLI](https://virtues.com/docs/operate/cli.md): The virtues command — checking the server's health, pairing devices, moving between releases, and the maintenance verbs you'll actually use.

## Understand

- [Glossary](https://virtues.com/docs/understand/glossary.md): The words Virtues uses for the parts of your life it holds — records, days, events, articles, pages, notebooks, applets — and what each one actually means.