Desktop app
Windows, macOS, Linux. Install, scan a QR, automate. Zero DevOps — unchanged and still the flagship.
SocialMate 2.0 · July 2026
Your WhatsApp server, anywhere.
The same app you run on your desk now runs on your server. SocialMate 2.0 adds a headless build for any Linux VPS — Docker or systemd — that you manage from the same GUI, right in your browser. The desktop app is unchanged, and still the flagship.
Spin up the whole automation server on a fresh VPS:
export SOCIALMATE_ADMIN_PASSWORD='choose-a-strong-one'
docker compose up -d
# → open http://your-vps:3456/admin and pair your number
One product, three ways to run it
Desktop when you want simple. A server when you want scale.
It is the same source, the same release, and every feature, REST endpoint and webhook — just packaged for where you want to run it.
Docker
One image, one volume, one command. Pull to update. Watchtower for hands-off upgrades.
VPS / systemd
A one-line installer, a hardened service, and a socialmate-update command. No container runtime required.
What shipped in 2.0
A real server, managed like an app.
The same GUI, in your browser
A headless server serves the exact desktop interface at /admin behind a single admin login. Pair accounts, change every setting, watch the live feed, manage your license — all remotely.
Reach it directly
A VPS has its own public IP, so the console and REST API are reachable straight away. Front it with a reverse proxy for TLS, or use the Pro named tunnel for automatic HTTPS.
Direct IP free · named tunnel on Pro
That public IP is a datacenter IP — route the account through your own residential/mobile proxy (Pro) to keep a residential connection.
QR pairing in the browser
Add an account from the web console and the linking QR appears right there — no screen-sharing into a headless box.
One seat, wherever it runs
The same machine-bound license covers a desktop or a server install — one seat per install. Your account page shows a Docker/VPS badge so you can tell them apart.
Updates that just pull
docker compose pull, or socialmate-update on systemd. Schema migrations run automatically on boot and your accounts survive — no re-pairing.
Encrypted at rest, no keychain
An operator-supplied key encrypts tunnel and API secrets on a headless box, and the server build is production-locked — server-authoritative, dev backdoors off.
Also new in this launch
A sharper toolkit for the AI agent you already run.
SocialMate is the WhatsApp tool and memory your own AI uses — through the n8n node, the MCP server, or the REST API. This launch rounds out that toolkit. SocialMate itself still doesn’t generate replies; that stays “coming soon”.
Agent Studio — free
A 10-step wizard in the app that turns your use-case into a ready system prompt, an importable n8n workflow, and an MCP config. Deterministic and offline — no AI needed to generate it.
Delivery receipts
New message.delivered and message.read webhook events close the loop for notification workflows — know a confirmation actually landed, not just that it was sent.
Pro
Polls with live results
Send a poll from a workflow, then read the tally back — votes arrive as webhook events and the results are queryable over the API, n8n and MCP.
Pro
Agent Memory
Your agent can save what it learned on the contact — names, notes, tags that WhatsApp sync can never overwrite — and cache media descriptions its own AI produced, returned on history and AI-context reads.
Pro
API keys with scopes
Mint a key that can only do what that integration needs — a read-only key for a dashboard, a send-scoped key for a workflow, an admin key for you.
The numbers
Every operation below is usable as an AI-Agent tool — in n8n natively, or over MCP.
Docker is your option — not your obligation
The open-source self-hosted APIs make Docker mandatory and leave you to build the anti-ban engine, the GUI, the storage and the search. SocialMate deploys the same way they do — a Docker image or a VPS — but you can also just run the desktop app with zero DevOps. Either way the anti-ban pipeline, the web console, a built-in database with full-text search, updates and support come in the box.
Same anti-ban pipeline. Same privacy. Every send still passes the full anti-ban pipeline, and your chats, contacts and media never leave your machine — desktop or server. There is still no SocialMate cloud in the middle.
One honest difference: the IP. The desktop app sends from your residential IP — the same home network as your phone. A VPS runs on a datacenter IP, which carries lower network reputation. It doesn’t make a VPS unsafe — the pipeline is identical — but for a safety-critical number, prefer the desktop app at home, or route the VPS account through your own residential/mobile proxy (Pro) to put it back on a residential IP. It removes a risk factor; no tool can guarantee against bans.
How we got here
Built in the open, release by release.
1
1.x — the foundation
The anti-ban pipeline, the smart queue, the local API and webhooks, conversational primitives (polls, locations, contact cards, replies, reactions), Agent Memory, the n8n node and the MCP server.
2
2.0 — July 2026 · self-host anywhere
The headless server build: Docker image, systemd installer, and the web admin console — the same GUI over the wire, from the same release as the desktop app.
→
The full, dated history
Every release, categorized and dated, lives on the changelog.
Run it your way.
The desktop app with zero DevOps, or the same server on Docker or a VPS. One flat license covers either.
Desktop · Docker · VPS · one flat license · nothing leaves your machine