# salt.md — documentation index > salt.md 1.0.1 is a self-hosted workspace for documents and structured > data. One binary serves the interface, a REST API, an MCP endpoint for agents, > a realtime collaboration relay and a change feed. Data is one SQLite file and > a folder of uploads, on a machine the owner controls. AGPL-3.0. This file indexes the 39 pages of the salt.md wiki. Each entry gives the address of the page as plain Markdown — fetch those, not the HTML. ## How to use this - Fetch the pages relevant to the question. They are written to stand alone, so one page is usually enough and there is no required order. - Every MCP tool name and every /api/ path in these pages is verified against the source on each build. You can act on them without checking first. - The interface calls a database a "collection"; the MCP tools call it a "database" (create_database, database_id). Both are correct in their place. - All examples are invented. No address, hostname or mail domain in this documentation belongs to a real instance. ## Start here - https://salt.md/wiki/concepts.md — the nouns the product is made of, and how they nest - https://salt.md/wiki/agents.md — the MCP endpoint, connecting, what an agent may do - https://salt.md/wiki/mcp-tools.md — the complete tool reference, one section per tool ## Using it Writing, finding and organising — the parts everybody touches. - https://salt.md/wiki/getting-started.md — Getting started: salt.md is one program: a single executable file that contains the server, the web interface, full-text search and the agent endpoint. - https://salt.md/wiki/concepts.md — Concepts: salt.md is built out of about fifteen nouns, and most questions about how it behaves turn out to be questions about which noun owns which. - https://salt.md/wiki/interface.md — The interface: This page describes the frame around your content: the sidebar, the document tabs, the topbar above a page, the account menu, the theme, every keyboard… - https://salt.md/wiki/pages.md — Pages: A page is the unit everything in salt.md is made of. - https://salt.md/wiki/editor-blocks.md — Editor blocks: The body of a document is a stack of blocks. A paragraph is a block, so is a heading, a list item, a table, an image, a callout, a whole two-column layout. - https://salt.md/wiki/comments-and-notes.md — Comments and notes: A page in salt.md carries two separate records beside its text, and they are not variations of one thing. - https://salt.md/wiki/search.md — Search: Search is the fastest way to reach anything in salt.md. - https://salt.md/wiki/files.md — Files: Anything you upload — a PDF, an image, a spreadsheet, a workspace logo — is stored as a file on disk beside the database, referenced from the page it was added… - https://salt.md/wiki/library.md — The library: The library fills the main area with every page of one workspace — a shelf you browse rather than a list you read. - https://salt.md/wiki/trash-and-recovery.md — Trash and recovery: No page in salt.md is deleted by clicking one button. ## Databases A page whose children are its rows, and everything that grows out of that. - https://salt.md/wiki/collections.md — Collections: A collection is a page whose child pages are its rows. - https://salt.md/wiki/properties.md — Properties: A property is a typed field on a collection. - https://salt.md/wiki/views.md — Views: A view is a saved way of looking at one collection: a type (table, board, calendar and four more), the conditions a row must meet to appear, the order the rows… - https://salt.md/wiki/relations-and-rollups.md — Relations and rollups: Three property types turn separate collections into one connected thing: a relation points at rows in another collection, a backrelation is that same link read… - https://salt.md/wiki/formulas.md — Formulas: A formula is a property of a collection that holds arithmetic instead of a value: *price times quantity*, *hours minus hours already billed*. - https://salt.md/wiki/forms.md — Forms: A form is one of the seven view types a collection can have. It draws the collection's properties as fields to fill in, and submitting it creates a row. - https://salt.md/wiki/templates.md — Templates and blueprints: Two ways to start from something instead of from nothing. A template copies one page — with everything filed under it — into a new page. ## Working together Who can see what, who did what, and what happens when two people type at once. - https://salt.md/wiki/workspaces.md — Workspaces: A workspace is the boundary around content. Every page in salt.md belongs to exactly one workspace, and you only see pages in workspaces you are a member of. - https://salt.md/wiki/permissions.md — Permissions: Who may see and do what. - https://salt.md/wiki/sharing.md — Sharing: salt.md is private by default: every page needs a signed-in account with access to the workspace it lives in. Publishing a page is the one deliberate exception. - https://salt.md/wiki/collaboration.md — Working at the same time: Two people can open the same document and type in it at once. Nothing locks, nothing asks who wins, and there is no save button. - https://salt.md/wiki/history-and-audit.md — History and audit: salt.md keeps four separate records, and they answer four different questions. - https://salt.md/wiki/account.md — Your account: Everything that belongs to you rather than to a workspace: how the account came into existence, your name, picture and colour, how you sign in, the second… - https://salt.md/wiki/language-and-time.md — Language and time: salt.md speaks the language your browser asks for and writes dates the way your region writes them, without anybody configuring anything. ## Agents The MCP surface: what an agent may do, with which credential, and every tool it has. - https://salt.md/wiki/agents.md — Agents: salt.md carries an MCP server inside the same binary that serves the interface. - https://salt.md/wiki/mcp-tools.md — MCP tools: salt.md speaks MCP (Model Context Protocol) on one endpoint, /mcp, and offers 33 tools. - https://salt.md/wiki/agent-access.md — Agent access: An agent reaches salt.md with a credential that belongs to a person. - https://salt.md/wiki/skill.md — The agent skill: salt.md can write an instruction bundle for itself: a small zip of Markdown that tells an AI agent how this team works here — the address of this instance,… ## Connecting things Everything that reaches outside the instance, in both directions. - https://salt.md/wiki/automation.md — Automation: salt.md connects to things outside itself in several ways: it calls an address of yours when a page changes, your calendar app subscribes to a feed of your… - https://salt.md/wiki/webhooks.md — Webhooks: A webhook is a standing instruction to call an address of your choosing when a page is created, changed or thrown away. - https://salt.md/wiki/import-export.md — Import and export: Getting content into salt.md and back out again. - https://salt.md/wiki/api.md — The REST API: Everything the salt.md interface does, it does over an HTTP API that you can call yourself: create pages, read and write database rows, search, upload files,… ## Running it For whoever owns the server: installing, updating, and the setup nobody enjoys. - https://salt.md/wiki/self-hosting.md — Self-hosting: This page is for whoever runs the server. - https://salt.md/wiki/administration.md — Administration: Running the instance: naming it, deciding who may get an account, inviting people, managing accounts through their whole life, cleaning up workspaces nobody is… - https://salt.md/wiki/domain.md — Reaching your instance from outside: A fresh salt.md listens on :8420 and answers on every network interface of the machine it runs on. That is enough for a laptop and for a server on your own network. - https://salt.md/wiki/sso.md — Single sign-on: salt.md can hand sign-in to Google or Microsoft. - https://salt.md/wiki/mail.md — Sending email: salt.md can send email, and it sends very little of it. - https://salt.md/wiki/desktop-app.md — The desktop app: salt.md has a desktop application. It is a window onto a server you run — not a second copy of the product, not a local instance, and not an offline mode. - https://salt.md/wiki/troubleshooting.md — Troubleshooting: Real failures, what they look like from the outside, and what actually fixes them. ## Elsewhere - https://salt.md/llms.txt — installing, running and connecting to an instance - https://salt.md/wiki/ — the same documentation as a website - https://github.com/saltmd/salt.md — the source Documentation generated from saltmd/salt.md@194047a: 39 pages, 28 screenshots.