OpenWA
OpenWA is a free, open-source WhatsApp API gateway for developers who want self-hosted messaging control.
Platform availability
Available on 1 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
78/100 Good
- Maintained
- 100last commit 2 days ago
- Popular
- 8517,059 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- 502 GB minimum RAM
- Security check
- 100no serious findings, CI, tests
Availability: platform listings confirmed today
- GitHub stars
- 17,059
- Open issues
- 4
- Last commit
- 2026-11-19
- Latest release
- v0.30.3
- License
- MIT
- Activity
- steady
Checked 3 days ago - source: GitHub (rmyndharis/OpenWA)
Resources & Compatibility
Minimum requirements: 2 GB RAM.
Checked 3 days ago - source: Docker Hub image tags and published docs
First-install notes
- Connect WhatsApp with the QR code After the app is running, start a session and get its QR code, then scan it with the WhatsApp app on your phone; if you are using the API commands, put your admin API key in the request's X-API-Key field (a named value the API checks) or OpenWA will reject the request. Without this connection, OpenWA will not send or receive WhatsApp messages. source
- Open the right local dashboard and API Use http://localhost:2886 for the dashboard and http://localhost:2785/api for the API on the machine running OpenWA. If you access it from another device, replace localhost with that machine's IP address so the browser can reach it, or you'll get a connection error. source
- Keep .env.minimal if you want pinned settings Copy the .env.minimal text settings file to .env if you want OpenWA to keep the minimal setup's fixed settings for the database, file storage, background jobs, session folder, and browser, instead of using dashboard defaults. It also stops WhatsApp sessions from starting automatically, which avoids surprises after a reboot. source
Fetched 3 days ago - each note links to its source
Variants
Alternatives (8)
- Baileys
- Venom Bot
- WppConnect Server
- evolution-api
- venom
- waha - WAHA is a self-hosted WhatsApp HTTP API (REST API) you can run on your own server in under 5 minutes, giving homelab users programmatic acc…
- whatsapp-mcp
- whatsapp-web.js
Checked 3 days ago - source: AlternativeTo
Common questions
How do I access the OpenWA dashboard and API from another machine?
On the OpenWA host, use port 2886 for the dashboard and port 2785 with the /api path for the API. From another device, replace localhost with the machine's IP address so the browser can reach it.
Can an authenticated WhatsApp session keep reconnecting after OpenWA restarts?
With authenticated HTTP/HTTPS session proxies, the whatsapp-web.js engine bypasses the WhatsApp Web service worker. This lets credentialed sessions keep reconnecting across restarts.
How can I force OpenWA to keep minimal settings and stop sessions from auto-starting after reboot?
Copy the .env.minimal settings file to .env. This pins the minimal database, file storage, background jobs, session folder, and browser settings and stops WhatsApp sessions from starting automatically.
Do incoming OpenWA webhooks include a signature for verification?
Yes, OpenWA supports HMAC webhooks. The webhook example includes an X-OpenWA-Signature header with a sha256 value.
Answers sourced from docs.open-wa.org, github.com, github.com, www.open-wa.org
Community
- Community guidelines - OpenWA (forum)
Collected 3 days ago - public community threads