# Docs

> Baalda documentation: install, sync, sharing, AI and self-hosting.

Source: https://baalda.com/docs
Site: Baalda, https://baalda.com

- [Introduction](https://baalda.com/docs/introduction.md). What Baalda is, the problem it solves, and how plain Markdown files and a live CRDT stay true at the same time.
- [Quickstart](https://baalda.com/docs/quickstart.md). Install the app, open your first vault, choose where it syncs, invite a teammate, and point an AI at it.
- [Core concepts](https://baalda.com/docs/concepts.md). The vocabulary: vault, note, docId, revision, the bridge, the registry, shares, sync tokens and recovery copies.
- [Vaults](https://baalda.com/docs/vaults.md). What a vault is on disk, local-only against synced, switching and leaving, and the two recovery paths when a folder goes missing.
- [The editor](https://baalda.com/docs/editor.md). Markdown that reads as a page, properties with real types, in-place tables, tabs, and the appearance settings that shape them.
- [Search, links and tags](https://baalda.com/docs/search-and-links.md). The local index: full-text search, backlinks that survive a rename, tags, and how the sidebar is sorted.
- [Attachments and files](https://baalda.com/docs/attachments.md). Which file types open, embed and search, the size ceilings, and the difference between embedded attachments and standalone file sync.
- [Versions and recovery](https://baalda.com/docs/versions-and-recovery.md). Version history, the version kept before a large deletion, the server's 30-day Trash, recovery copies, and restoring damaged notes.
- [Members and roles](https://baalda.com/docs/members.md). Inviting people by email or join code, what each role may do, and the roster, profiles and activity behind a vault.
- [Access control](https://baalda.com/docs/access.md). The three controls that decide who sees what, how grants combine, and what a restriction does to the files already on someone's disk.
- [Sync and offline](https://baalda.com/docs/sync.md). The two channels, what the sync indicator means, what happens after time offline, and when a server is behind the app.
- [Presence and voice](https://baalda.com/docs/presence-and-voice.md). Live cursors, who is in a note, online status, and the hold-to-talk broadcast that is never recorded.
- [AI overview](https://baalda.com/docs/ai-overview.md). Two ways an agent works a vault: directly on the files when it can reach your disk, and over MCP when it cannot.
- [Connect an AI over MCP](https://baalda.com/docs/mcp-setup.md). Create a token, register the endpoint, and connect Claude Code, a custom connector or any MCP client.
- [Deploy the server](https://baalda.com/docs/deploy.md). What the server is, the one port it needs, and four ways to run it: Docker, Compose, Railway or Coolify.
- [Configuration](https://baalda.com/docs/configuration.md). The environment variables the server reads: the required three, then sync, batching, storage, email, billing and scale.
- [Attachment storage](https://baalda.com/docs/attachment-storage.md). Keep attachment bytes in Postgres, or move them to S3-compatible storage, with garbage collection and a verified migration.
- [Outbound email](https://baalda.com/docs/email.md). What switches on when you configure a transport, what happens when you do not, and which transports are accepted.
- [Scaling and operations](https://baalda.com/docs/scaling.md). What one instance handles, what Redis buys you, how upgrades and staging work, and what to back up.
- [Connect the app to your server](https://baalda.com/docs/connect-clients.md). How the desktop app chooses a server, the one-link invitation path, and the URL rules packaged builds enforce.
- [Build from source](https://baalda.com/docs/build-from-source.md). Prerequisites, then the commands that bring up the server and the desktop app from the repository.
- [MCP tool reference](https://baalda.com/docs/mcp-tools.md). All 22 tools the MCP endpoint exposes, with their parameters, their defaults and what refuses a call.
- [Settings reference](https://baalda.com/docs/settings.md). Every tab in Vault Settings and what it controls, plus what the account menu carries.
- [Architecture](https://baalda.com/docs/architecture.md). The four pillars, the two join keys, the three stores on a client, and the specification set behind each.
- [Plans and limits](https://baalda.com/docs/plans.md). Self-hosting is free and unlimited. On the managed backend, what Free includes, what Team adds, and what a lapsed plan does.
- [Troubleshooting](https://baalda.com/docs/troubleshooting.md). The problems that actually come up: a server behind the app, a missing folder, notes that will not sync, and uploads that fail in the client.
- [Security and privacy](https://baalda.com/docs/security.md). What travels the network, where credentials are kept, how access is enforced, and how to report a vulnerability.
- [Releases, licence and contributing](https://baalda.com/docs/releases.md). How versions ship and update themselves, where the changelog lives, what the licence allows, and how to contribute.