Mandala Docs
Mandala is your own home for your life and your businesses: the people you talk with, what you know, what you have to do, your money and your company's rules, with an accomplice that works through all of it with you. It runs on a machine you control.
These pages ship with Mandala and update with every release. Ask your accomplice anything that starts with "how do I…" and it answers from here, with a link to the page it used.
Start here
- What is Mandala — the idea in five minutes.
- Choose where Mandala runs — a Mac, a home server or a VPS.
- Install on Linux — install Mandala on a Linux machine.
- The first run — the first start, and what to set.
- Choose a model — connect the AI model your accomplice thinks with.
- Your first hour — a guided first hour, from hello to a sent email.
The manual
| Part | What it covers |
|---|---|
| Getting started — Getting started | What Mandala is, installing it, the first run, models, your first hour. |
| Your accomplice — Your accomplice | Talking, showing, voice, approvals, autonomy, memory, goals and the diary. |
| Connecting your life — Connecting your life | Email, calendar, Drive, Telegram, WhatsApp, Apple Health, analytics, GitHub, MCP. |
| Workspace guide — Workspace guide | Every page of the app: Communications, Knowledge, Library, Personal, Tasks, Code… |
| Businesses and teams — Businesses and teams | Identities, ownership, delegation, acting for a company, exchange between businesses. |
| Devices and sync — Devices and sync | The Mac and iPhone apps, pairing, sync, conflicts, keys and recovery. |
| Building with DHL — Building with DHL | Write the rules of a business as contracts: tutorial, language, queries, UI files. |
| Administration — Administration | Settings, models and routing, notifications, backups, updates, logs. |
| Sysops — Sysops | Architecture, installing and running servers, network, monitoring, security. |
| Reference — Reference | Glossary, shortcuts, HTTP API, environment, CLI, file formats, FAQ, changelog. |
What "Coming soon" means
Mandala is built in the open and moves fast. Every page describes what runs today. Where a feature is designed and being built but not yet in your release, the page says so with a Coming soon badge at the top or next to the paragraph concerned, and tells you what to do in the meantime. What's coming lists them all.
A word on names
Each person defines their own accomplice: a plain assistant, a colleague with a name, or an accomplice with a personality, a face and a voice. This manual says your accomplice. Current builds still label a few places with the name of the first accomplice, Alma: the first item in the sidebar, the composer ("Message Alma"), and the accomplice's group in Settings. When this manual writes Settings → Accomplice, that group is the one labelled Alma today. These labels take your accomplice's name once personas land Coming soon.
About this vault
This is the Docs vault: an ordinary Goethe vault, created on every Mandala node and refreshed from each release. You can search it, link to it and add notes; see The Docs vault for how updates treat your edits.