# dembrane documentation

> Capture, transcribe, and make sense of conversations at scale - guides for every kind of dembrane user.

## Docs

- [dembrane documentation](https://docs.dembrane.com/index.md): Capture, transcribe, and make sense of conversations at scale - guides for every kind of dembrane user.
- [Getting started as a host](https://docs.dembrane.com/users/host/getting-started.md): The fast path from sign-up to your first analysed conversation - onboarding, your first project, the portal, the QR, and reading what…
- [For participants](https://docs.dembrane.com/users/participant/index.md): Someone invited you to record with dembrane - here's the promise, and what these pages cover.
- [For hosts](https://docs.dembrane.com/users/host/index.md): You run sessions and make sense of them - create projects, collect conversations, read transcripts, chat with your data, and build reports.
- [Partner overview](https://docs.dembrane.com/users/host-partner/index.md): Who a partner host is, when partner features apply, and where to find them.
- [For staff](https://docs.dembrane.com/users/staff/index.md): You work at dembrane - billing, account health, upgrade requests, partner operations, and trainings, all through the admin panel.
- [Building on dembrane (external developers)](https://docs.dembrane.com/users/developer-external/index.md): Self-host dembrane, integrate with its API, or contribute to the open-source project - start here.
- [Internal developer overview](https://docs.dembrane.com/users/developer-internal/index.md): Orientation for dembrane engineers - repo layout, where things live, and a map of the internal developer guides.
- [Feature catalogue](https://docs.dembrane.com/features/index.md): Every dembrane capability on its own terms - what it is, when you'd use it, and who it's for.
- [Documentation map](https://docs.dembrane.com/map.md): Every page in the dembrane documentation, grouped by feature and by who you are.
- [Creating a project](https://docs.dembrane.com/users/host/creating-a-project.md): The create wizard from a host's point of view - project vs workspace, and the settings that matter most.
- [Setting up the portal](https://docs.dembrane.com/users/host/portal-editor.md): A host's walkthrough of the portal editor - title, description, finish text, key terms, name and email, anonymisation, verification, Get…
- [Tiers & billing](https://docs.dembrane.com/features/tiers-and-billing.md): dembrane's plans - Free, Innovator, Changemaker, Guardian - what each unlocks, how per-seat pricing works, and how billing is organised.
- [Account & security](https://docs.dembrane.com/features/account-and-security.md): Your dembrane account - profile and display name, password, two-factor authentication, audit logs, appearance and language, and your…
- [Using dembrane Go on mobile](https://docs.dembrane.com/users/host/using-dembrane-go-mobile.md): A host's guide to the dembrane Go iOS app - when to record on mobile versus the web, what syncs, and what stays web-only.
- [Collecting conversations](https://docs.dembrane.com/users/host/collecting-conversations.md): Every way to gather input into a project - the participant portal and QR, the direct link, recording yourself, uploading text, and…
- [Transcripts & conversations](https://docs.dembrane.com/users/host/transcripts-and-conversations.md): The host workflow for what you've collected - reading transcripts and summaries, tags, locking, bulk actions, retranscribe, delete, and…
- [Chat & Ask](https://docs.dembrane.com/features/chat-and-ask.md): Ask questions across your conversations and get answers with cited sources - one assistant that searches, reads, and shows its work.
- [Reports](https://docs.dembrane.com/features/reports.md): One-click synthesis of all your conversations - share the link, download a PDF, or auto-send to participants.
- [Library & analysis](https://docs.dembrane.com/features/library-and-analysis.md): Automatically extracted topics, aspects and quotes across all your conversations - the standing view for large datasets.
- [Roles & permissions](https://docs.dembrane.com/features/roles-and-permissions.md): Who can do what in dembrane, and which role to pick when you invite someone.
- [What to expect](https://docs.dembrane.com/users/participant/what-to-expect.md): The whole flow, from opening the link or scanning the code to finishing - step by step.
- [Recording your conversation](https://docs.dembrane.com/users/participant/recording-your-conversation.md): How to record well, how to pause and stop, the type-instead option, and what to do if something isn't working.
- [Refining & verifying](https://docs.dembrane.com/users/participant/refining-and-verifying.md): Reviewing what you recorded, choosing what to keep, and checking that the points captured from your words are right.
- [Your privacy & your data](https://docs.dembrane.com/users/participant/your-privacy-and-data.md): What happens to your words, how your privacy is protected, how consent works, and how to opt out.
- [Your report](https://docs.dembrane.com/users/participant/your-report.md): If the organiser turns it on, the summary you can see at the end - what it shows and what it's for.
- [Transcription](https://docs.dembrane.com/features/transcription.md): How dembrane turns recorded audio into accurate, multilingual text - key terms, anonymisation, and re-transcription.
- [Export & data portability](https://docs.dembrane.com/features/export-and-data-portability.md): Getting your data out of dembrane - transcript downloads, CSV and Excel exports, report exports, and the API for everything else.
- [Getting help](https://docs.dembrane.com/users/host/getting-help.md): Every way to reach the dembrane team, and what to do when something is stuck or broken.
- [Observer & external collaborators](https://docs.dembrane.com/users/host-partner/observer-and-external-collaborators.md): The free read-only observer versus the paid external collaborator - what each can do, and when to use which.
- [Becoming a partner](https://docs.dembrane.com/users/host-partner/becoming-a-partner.md): How an organisation becomes a dembrane partner, what it unlocks, and the partner agreement.
- [External-client workspaces](https://docs.dembrane.com/users/host-partner/external-client-workspaces.md): Creating a workspace that belongs to a client - the data-owner step, separate billing, the free observer, and whitelabel.
- [Data ownership & handoff](https://docs.dembrane.com/users/host-partner/data-ownership-and-handoff.md): Naming a data owner, the partner agreement, moving projects and workspaces, and handing a workspace over to the client.
- [Referrals](https://docs.dembrane.com/users/host-partner/referrals.md): The referral ledger, the kickbacks and discounts dembrane staff administer, and what a partner sees.
- [The partner program](https://docs.dembrane.com/features/partner-program.md): How agencies and consultancies run dembrane on behalf of external clients - partner organisations, external-client workspaces, the…
- [Data ownership & compliance](https://docs.dembrane.com/features/data-ownership-and-compliance.md): Who owns the conversations in a workspace - internal vs external workspaces, the data owner, partner agreements, white labeling, and…
- [The admin panel](https://docs.dembrane.com/users/staff/admin-panel-overview.md): How to reach the dembrane admin panel, how its sections fit together, and the kebab-action model that runs through all of it.
- [Usage & billing rollup](https://docs.dembrane.com/users/staff/usage-and-billing-rollup.md): The master staff view of every account - usage per account and workspace, revenue class, MRR forecast, admin contacts, CSV export, and a…
- [Account health & at-risk](https://docs.dembrane.com/users/staff/at-risk-and-account-health.md): The staff at-risk list - pilot hard-blocks, at-cap and approaching-cap accounts, recent downgrades - sorted by severity, and the…
- [Upgrade requests](https://docs.dembrane.com/users/staff/upgrade-requests.md): The staff queue for workspace upgrade requests - submit, list, approve, deny - its two kinds, how notifications batch into a daily…
- [Managed & offline billing](https://docs.dembrane.com/users/staff/managed-and-offline-billing.md): How staff bill customers who don't pay self-serve - set managed, assign an account manager, issue a payment link or invoice, and mark…
- [Discounts, trials & tiers](https://docs.dembrane.com/users/staff/discounts-trials-and-tiers.md): The staff levers on an account - apply a discount, grant a reverse trial, change a tier, change the admin, and reset usage with a reason.
- [Partner administration](https://docs.dembrane.com/users/staff/partner-administration.md): The staff side of the partner program - the partner toggle, the referral ledger, the external-led-orgs conversion signal, and helping…
- [Trainings & licences](https://docs.dembrane.com/users/staff/trainings-and-licences.md): Staff training administration - the catalogue, scheduling sessions, completing them to grant one-year licences, and managing the roster.
- [Staff support access](https://docs.dembrane.com/features/staff-support-access.md): Temporary, secure admin access for dembrane support staff to help troubleshoot your workspace - fully controlled by you and…
- [Trainings](https://docs.dembrane.com/features/trainings.md): Compliance trainings for high-stakes settings - how they work, the one-year licence they grant, who requests them, and how hosts and…
- [Licensing](https://docs.dembrane.com/users/developer-external/licensing.md): dembrane is BSL 1.1 - free for non-production and for small organisations in production, converting to GPLv3 after three years.
- [Self-hosting dembrane](https://docs.dembrane.com/users/developer-external/self-hosting.md): The services dembrane needs, the dev container, ports, environment files, and EU-residency options for running it yourself.
- [Configuration & LLM providers](https://docs.dembrane.com/users/developer-external/configuration-and-llm-providers.md): Wire up language models with the LiteLLM router, configure transcription and embeddings, choose EU regions, and set the key feature toggles.
- [Authentication](https://docs.dembrane.com/users/developer-external/authentication.md): How dembrane authenticates API requests - Directus JWTs, static integration tokens, and the staff admin_access claim.
- [The participant API](https://docs.dembrane.com/users/developer-external/participant-api.md): The unauthenticated endpoints the portal uses to record conversations - fetch project metadata, initiate a conversation, and upload…
- [Webhooks](https://docs.dembrane.com/users/developer-external/webhooks.md): Subscribe to conversation and report events, manage webhook endpoints over the API, and verify the HMAC-SHA256 signature on every delivery.
- [Export & integrations](https://docs.dembrane.com/users/developer-external/export-and-integrations.md): Pull transcripts, reports, and tabular data out of dembrane programmatically - transcript zips, per-conversation text, and CSV/Excel.
- [MCP & bring-your-own-LLM](https://docs.dembrane.com/users/developer-external/mcp-and-byo-llm.md): The forthcoming way to connect your own assistant - ChatGPT, Claude - to your dembrane data, and where it sits today.
- [Contributing](https://docs.dembrane.com/users/developer-external/contributing.md): How to contribute to dembrane - pull requests, the CLA, the code of conduct, security disclosure, and the community Slack.
- [Architecture](https://docs.dembrane.com/users/developer-internal/architecture.md): The services that make up dembrane, the ports they run on, the v1/v2 API split, the BFF and service layers, and how authentication works.
- [The processing pipeline](https://docs.dembrane.com/users/developer-internal/processing-pipeline.md): What happens between an uploaded audio chunk and a finished, summarised conversation - transcription, correction, merge, summarise,…
- [The data model](https://docs.dembrane.com/users/developer-internal/data-model.md): The Directus collections behind dembrane and how org, workspace, project, conversation and the rest relate to one another.
- [Chat & the agent service](https://docs.dembrane.com/users/developer-internal/chat-and-agent.md): How standard RAG chat and agentic chat differ, the standalone LangGraph agent service on :8001, its tools, and the lease-based turn…
- [Roles & policies in code](https://docs.dembrane.com/users/developer-internal/roles-and-policies.md): How policies.py enforces access - presets, the IAM-style policy model, tier gates, seats, inheritance, and how to add a capability or a…
- [Background jobs & scheduler](https://docs.dembrane.com/users/developer-internal/background-jobs-and-scheduler.md): The Dramatiq queues, the no-asyncio-in-actors rule, every scheduled job, and the Redis keys that coordinate them.
- [Local development](https://docs.dembrane.com/users/developer-internal/local-development.md): Run the whole dembrane stack on your machine - the devcontainer, mprocs services and ports, env files, and the MinIO option for S3.
- [Deployment & releases](https://docs.dembrane.com/users/developer-internal/deployment-and-releases.md): How dembrane ships - main to echo-next on merge, tags to production, the testing-branch reset rule, the GitOps repo, Dockerfiles, and…
- [Developing & maintaining the docs](https://docs.dembrane.com/users/developer-internal/maintaining-docs.md): How this documentation stays true to the code - the two-way sync between docs and codebase, the code-to-docs process, and the review gate.
- [Guides by who you are](https://docs.dembrane.com/users/index.md): Pick the dembrane guide that matches your role - host, partner, staff, participant, or developer.
- [Organisations & workspaces](https://docs.dembrane.com/features/organisations-and-workspaces.md): How dembrane is structured - organisations hold workspaces, workspaces hold projects - and how membership and billing flow through that…
- [Invites & access](https://docs.dembrane.com/features/invites-and-access.md): How people join a workspace or organisation in dembrane - invites by email or link, accepting, pending invites, access requests, and how…
- [Visibility & discovery](https://docs.dembrane.com/features/visibility-and-discovery.md): How dembrane decides who can see and find a workspace - open to the organisation, invite-only, or private - and the one transition…
- [Projects](https://docs.dembrane.com/features/projects.md): A project is where a body of conversations and its analysis live - how to create one, configure it, and share it.
- [Recording](https://docs.dembrane.com/features/recording.md): How dembrane captures audio - in the participant portal, by a host, and on mobile - and what happens to it as it records.
- [The live monitor](https://docs.dembrane.com/features/live-monitor.md): Watch participant flow, mic checks, and recording in real time during a session.
- [The participant portal](https://docs.dembrane.com/features/portal-and-participant-experience.md): The no-account experience people use to record for you - from the welcome cards through consent, recording, refining, verifying, and an…
- [The portal editor](https://docs.dembrane.com/features/portal-editor.md): How a host configures the participant portal - onboarding, languages, key terms, anonymisation, verification, replies, and the QR/invite…
- [dembrane Go (the mobile app)](https://docs.dembrane.com/features/mobile-app-dembrane-go.md): The native iOS recorder for facilitators - local-first chunked recording, background capture, conversations, chat, and portal settings…
- [Conversations & transcripts](https://docs.dembrane.com/features/conversations-and-transcripts.md): Read, copy, summarise, tag, verify, lock, retranscribe and organise everything you've collected in a project.
- [Notifications](https://docs.dembrane.com/features/notifications.md): How dembrane keeps you informed - in-app and email notifications, digest batching, tier-expiry warnings, workspace-request alerts, and…
- [Webhooks & integrations](https://docs.dembrane.com/features/webhooks-and-integrations.md): React to events in dembrane from your own systems - webhook events, creating and testing them, signature verification, and the tier…
- [MCP & bring-your-own-LLM](https://docs.dembrane.com/features/mcp-and-bring-your-own-llm.md): Connect your own language model or assistant to dembrane - how analysis differs across tiers, the Innovator BYO-LLM and MCP integration,…
- [5 ways to use dembrane](https://docs.dembrane.com/features/five-ways-to-use-dembrane.md): An overview of the five functional layers of dembrane and how to apply them to dialogue and deliberative processes.
- [dembrane next (preview features)](https://docs.dembrane.com/features/dembrane-next.md): dembrane next is the staging environment that gets every change before production.
- [Building now](https://docs.dembrane.com/building/index.md): Features dembrane is actively designing and building - written as user stories first, so the docs lead the build and you can see what's…
- [Troubleshooting transcripts & summaries](https://docs.dembrane.com/users/host/troubleshooting-transcripts-and-summaries.md): What to do when a transcript reads poorly, a summary misses the point, or something seems stuck in processing.
- [Chat & Ask - for hosts](https://docs.dembrane.com/users/host/chat-and-ask.md): As a host, ask questions of your conversations and get cited answers - one assistant that searches and shows its work, with the classic…
- [Library & analysis - for hosts](https://docs.dembrane.com/users/host/library-and-analysis.md): As a host, let dembrane read across a large set of conversations and surface the topics, aspects, and quotes - when to generate it, how…
- [Reports - for hosts](https://docs.dembrane.com/users/host/reports.md): As a host, assemble findings into a shareable report - sections, timeline, scheduling, and export.
- [Managing your workspace - for hosts](https://docs.dembrane.com/users/host/managing-your-workspace.md): As an owner or admin, run your workspace - members, invites and roles, visibility, data ownership, and settings.
- [Tiers, billing & usage - for hosts](https://docs.dembrane.com/users/host/tiers-billing-and-usage.md): As a host, understand the plans, seats, and metered usage - what each tier unlocks, how to upgrade, and how to request one.
- [Account & settings - for hosts](https://docs.dembrane.com/users/host/account-and-settings.md): As a host, look after your personal account - profile, password, two-factor, appearance and language, your access, and audit logs.
- [The SMART loop (building now)](https://docs.dembrane.com/building/smart-loop.md): A user story for the living canvas - a live, versioned page the assistant regenerates every few minutes during a session, improved by chat.
- [dembrane documentatie](https://docs.dembrane.com/index.nl-NL.md): Gesprekken op grote schaal vastleggen, transcriberen en begrijpen - gidsen voor elk type dembrane-gebruiker.
- [Problemen met transcripten & samenvattingen oplossen](https://docs.dembrane.com/users/host/troubleshooting-transcripts-and-summaries.nl-NL.md): Wat je kunt doen als een transcript slecht leesbaar is, een samenvatting de plank misslaat of de verwerking vastloopt.