Browse documentation
Outbound OS documentation
Everything needed to install, connect and run a self-hosted Outbound OS. New here? Start with the install guide — it takes about five minutes.
Get started
Install Outbound OS with Docker
Install Outbound OS, the open-source WhatsApp CRM, with Docker Compose: clone, set an admin email, start, then put it behind HTTPS. Includes HTTPS and channel setup guidance.
Configuration reference
Every Outbound OS setting that matters: admin sign-in, business identity, time zone, currency, country code, WhatsApp webhooks, email, encryption and MCP.
Connect
Connect the WhatsApp Cloud API
Step-by-step: create a Meta app, get a permanent System User token, connect your number to Outbound OS, receive replies by webhook and set a first-contact template.
Website forms and lead webhooks
Send leads to Outbound OS from HTML forms, Zapier, Make, n8n, marketplace or your own code: addresses, keys, field names, field maps, test mode and responses.
Set up the MCP server
Run the Outbound OS MCP server and connect Claude Code or claude.ai to your CRM: tokens, the Docker profile, HTTPS, OAuth and tool approvals.
Integration guides
WhatsApp Cloud API
Meta's official API, no reseller in between. Templates, replies and read receipts.
Email (SMTP / IMAP)
SMTP sending and IMAP reply sync for mailboxes that permit these connections.
Brevo
Email sending and reviewed marketing batches with a saved template, selected senders and an explicit country audience.
Telegram
Your own Telegram account, for one-to-one conversations with leads.
iMessage
Through a Mac running BlueBubbles, reached over an HTTPS tunnel.
Facebook Lead Ads
Meta instant-form leads through an automation provider, with mapped contact details and consent.
Zapier, Make and n8n
One webhook step turns any app into a lead source.
Google Sheets
A live row for every new lead and reply, through a small Apps Script.
Lead intake & webhooks
Source-key lead intake, reviewed imports and signed outgoing events.
CSV import
CSV upload with column detection and merging; export back to CSV any time.
Stuck?
Ask in GitHub Discussions, or open an issue if something is broken. Security problems go to private vulnerability reporting, never a public issue.