# mindin documentation

Start with [Install with Docker](/docs/main/install/docker.md): it takes you from an empty machine to a vault server you can connect claude.ai to.

## Tutorial

- [Install with Docker](/docs/main/install/docker.md): a vault server with Docker Compose and Caddy, your account, your first vault.

## How-to guides

Installing:

- [Storage](/docs/main/install/storage.md): a local folder or an S3 bucket, and what the bucket's key needs.
- [Search by meaning](/docs/main/install/semantic-search.md): the `-semantic` image, the model from Hugging Face, memory.
- [Install on Kubernetes](/docs/main/install/kubernetes.md): the manifests in `deploy/k8s/`.
- [Run a server without Docker](/docs/main/install/without-docker.md): the Python package behind your own TLS.
- [Behind a reverse proxy](/docs/main/how-to/reverse-proxy.md): another proxy in place of Caddy, the `Host` header and the client's address.

Connecting:

- [Connect claude.ai, Claude Desktop and mobile](/docs/main/how-to/connect-claude-ai.md)
- [Sign a machine in to a server](/docs/main/how-to/sign-in-a-machine.md): `login`, and several vaults on one machine.
- [Use it with Claude Code](/docs/main/how-to/claude-code.md): the plugin, or the server and hooks by hand.
- [Use it with Codex, Cursor and other clients](/docs/main/how-to/other-clients.md): stdio clients, URL clients, keys, kebbie.
- [Open a server vault in Obsidian](/docs/main/how-to/obsidian.md)

Running a server:

- [Set up sign-in methods](/docs/main/how-to/sign-in-methods.md): email links, GitHub, your identity provider, a trusted proxy, passkeys.
- [Manage accounts and vaults](/docs/main/how-to/manage-accounts.md): invitations, suspension, more vaults, sharing.
- [Back up and rotate keys](/docs/main/how-to/back-up-and-rotate.md)
- [Open a vault for support, or import one](/docs/main/how-to/support-access-and-import.md)

Keeping a vault tidy:

- [Run lint every week](/docs/main/how-to/weekly-lint.md)

## Reference

- [Configuration](/docs/main/reference/configuration.md): every environment variable.
- [MCP tools](/docs/main/reference/tools.md)
- [Command line](/docs/main/reference/command-line.md)
- [Agent commands](/docs/main/reference/agent-commands.md): `task`, `log`, `snapshot` and `status`, JSON out.
- [Hooks](/docs/main/reference/hooks.md): `session-start` and `stop`.
- [The schema file](/docs/main/reference/schema.md): `.vault/schema.yml`.
- [Device flow](/docs/main/reference/device-flow.md): signing a tool in without a browser.
- [Extensions](/docs/main/reference/extensions.md): adding tables, pages, routes and commands to a server from a package of your own.

## Explanation

- [How it works](/docs/main/explanation/how-it-works.md): the index, session start, writes.
- [Notes and layouts](/docs/main/explanation/notes-and-layouts.md): folders, kinds, presets.
- [Lifecycle, backlog and the repo log](/docs/main/explanation/lifecycle.md)
- [Search](/docs/main/explanation/search.md): ranking by words and by meaning.
- [Accounts and vaults on a server](/docs/main/explanation/accounts-and-vaults.md)
- [Shared vaults](/docs/main/explanation/shared-vaults.md)
- [Encryption on a server](/docs/main/explanation/encryption.md)