How-to guides

TitleSectionSummary
Backups and restoreAdministrationBack up the data directory safely, restore it, and what a second node does and does not replace.
Keys and credentialsAdministrationHow Mandala stores API keys and sign-ins, and how to add, replace and remove them.
LogsAdministrationWhere Mandala writes what it does, and how to get more detail.
Models and workload routingAdministrationRoute each kind of work to the right model, set reasoning effort, and keep costs in check.
NotificationsAdministrationGet your accomplice's alerts, replies and approval requests on your phone and computers.
UpdatesAdministrationLet Mandala update itself from signed releases, or install a build by hand — with automatic rollback either way.
Users and permissionsAdministrationYour account, sign-in and sessions, Face ID for sensitive acts, and who else can reach your Mandala.
Testing contractsBuilding with DHLProve that a contract accepts what it should and refuses what it should — before it holds real records.
Upgrading a contractBuilding with DHLChange a contract that already has records — signed upgrades, migrate blocks and archived versions.
The WorkbenchBuilding with DHLWrite a contract, try it on a throwaway node, and install it — from the app or with your accomplice.
Acting for a companyBusinesses and teamsSwitch who you act as, and what changes across the app and for your accomplice.
Exchange between businessesBusinesses and teamsRecognize counterparts, send and receive signed documents, and introduce people.
Inviting peopleBusinesses and teamsBring colleagues and household members into your home, each with their own identity and accomplice.
Who owns whatBusinesses and teamsGive each mailbox, chat account, conversation and vault an owner — and move a single chat to your company.
AhrefsConnecting your lifeSEO data for your accomplice, within a daily units budget.
Apple HealthConnecting your lifePush daily health measurements and workouts from your iPhone into your personal records.
Cloudflare and webhooksConnecting your lifeLet services reach Mandala through a dedicated tunnel, and let your accomplice manage DNS and zones with approval.
Set up your emailConnecting your lifeGmail in Communications — mailboxes, signatures, translation, and what your accomplice may do.
Facebook and InstagramConnecting your lifePublish to your Pages and Instagram accounts with approval, and let comments reach your accomplice.
GitHubConnecting your lifeRepositories your accomplice may read and change, with approval for every change.
Google Calendar, Drive, Docs and SheetsConnecting your lifePer-account, per-service access to your calendars, files and documents.
MCP serversConnecting your lifeAdd tools from any remote MCP server, reviewed one by one.
Meta AdsConnecting your lifeAd accounts your accomplice may read, and where it may propose changes.
PostHogConnecting your lifeProduct analytics your accomplice can read, with events and thresholds that wake it.
TelegramConnecting your lifeSign in with your own Telegram accounts and choose, chat by chat, what your accomplice reads.
Web search and picturesConnecting your lifeBrave Search for the web, WaveSpeed for generated pictures.
WhatsAppConnecting your lifeLink your WhatsApp number as a companion device, like WhatsApp Web.
Install the web app on your phoneDevices and syncAdd Mandala to your Home Screen, with its own icon, window and notifications.
Join a device with a codeDevices and syncAdd a new phone, computer or browser by scanning a temporary QR or typing a short code, approved with Face ID.
Keys and recoveryDevices and syncWhat decides which devices are yours — and how you get back in if you lose them.
The Mac app as a second nodeDevices and syncJoin your Mac to your home so it keeps a copy, works offline, and syncs.
Pair two nodesDevices and syncMake two Mandala nodes sync — by device key, over Tailscale or the device mesh.
Choose a modelGetting startedConnect the AI model your accomplice thinks with — a sign-in, an API key or a local model.
The first runGetting startedCreate your identity with a first name and Face ID, choose what powers your accomplice, and you're in.
Install on a MacGetting startedMandala for Mac — one app that is a full node, with its window and menu bar item.
Install on a VPSGetting startedRun your Mandala home on a rented server you control.
Install on LinuxGetting startedBuild Mandala, install it as a systemd service, and open it over Tailscale.
Meet your accompliceGetting startedDecide who your accomplice is — from a plain assistant to an accomplice with a personality.
MonitoringSysopsKnow that Mandala is up and healthy — health check, service state, disk and the app's own signals.
Tailscale and HTTPSSysopsReach Mandala privately from your devices over HTTPS, with a stable name.
TroubleshootingSysopsCommon problems, what they mean, and how to fix them.
AgendaWorkspace guideYour Google calendars and dated tasks in one calendar, by day or week.
CodeWorkspace guideRun coding agents in your repositories from any device — approvals, CI fixes, reviews and pull requests.
CommunicationsWorkspace guideMail, Telegram and WhatsApp in one place, by person, with your accomplice at hand.
DashboardsWorkspace guideThe payables board — supplier invoices from received to paid, every step signed.
DataWorkspace guideThe back office — every record your rules govern, queries, actions with previews, and the Workbench.
Folders, moves and tidy-upsWorkspace guideKeep a vault in order — folders, moves that keep links, and tidy-up plans you review before they apply.
Types, views and type actionsWorkspace guideGive documents a shape with types, query them with views, and add actions to types.
KnowledgeWorkspace guideVaults of Markdown documents with types, links, tasks, calculations and live co-editing.
LibraryWorkspace guideEvery file in one place — attachments, uploads and your accomplice's work, filed with reasons.
PersonalWorkspace guideGroceries, money and health — lists by aisle, accounts and budgets, measurements and goals.
PinsWorkspace guideBookmarks to anything in the Workspace or on the web, in folders, with up to seven superpins always at the top of the sidebar.
TasksWorkspace guideEvery task across your documents, filtered, grouped and scheduled by dragging.
ApprovalsYour accompliceApprove what your accomplice prepared — with a tap, from your phone, or in your own words.
What your accomplice may do aloneYour accompliceChoose, family by family, what your accomplice does without an approval card.
Choices, reactions and branchesYour accompliceAnswer with a tap, react with an emoji, and take a message aside to think it through.
Memory and rulesYour accompliceWhat your accomplice remembers, the rules it always follows, and how to change both.
Sensitive modeYour accompliceAn explicit, adult-only opt-in for private conversations with your own accomplice.
Talking with your accompliceYour accompliceThe conversation, attachments, replies, and the accomplice panel on every page.
Voice messages and callsYour accompliceTalk instead of typing — voice messages, spoken replies and live calls.