OpenWA

OpenWA is a free, open-source WhatsApp API gateway for developers who want self-hosted messaging control.

  • Communication
OpenWA is a free, open-source WhatsApp API gateway for developers who want self-hosted messaging control. It exposes an HTTP API and Webhooks for sending messages and managing sessions while letting you choose SQLite, PostgreSQL, local or S3 storage, and optional Redis for queueing, rate limiting, and fan-out.

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

Alternatives (8)

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

Collected 3 days ago - public community threads