
Deploy WAHA
Self-hosted WhatsApp HTTP API: GOWS engine, persistent sessions, dashboard
Just deployed
/app/data
Deploy and Host WAHA on Railway
WAHA (WhatsApp HTTP API) is an open-source, self-hosted REST API for WhatsApp. You link a WhatsApp number by scanning a QR code, then send and receive messages, media and group events over HTTP and webhooks. It ships with a web dashboard and Swagger API docs, and runs from a single Docker image.
About Hosting WAHA
This template runs WAHA Core 2026.10.1 with the GOWS engine, a Go client that runs without a browser. Railway builds it from a public GitHub repo that pins the official image by digest, so you get update notices when a new version is merged. WhatsApp logins and downloaded media are kept on a Railway volume at /app/data, and sessions reconnect on their own after a redeploy. The API key, dashboard password and Swagger password are generated for each deploy, so nothing is left on a default. You only need to scan the QR code once.
Common Use Cases
- Send order updates, reminders and one-time codes to customers on WhatsApp from your own app
- Receive incoming WhatsApp messages as webhooks in n8n, Chatwoot, Make or your own backend
- Build WhatsApp chatbots and AI assistants without per-message fees
Dependencies for WAHA Hosting
- One WhatsApp account (phone number) to link by QR code
- A Railway volume for sessions and media (included)
Deployment Dependencies
- WAHA source and releases: https://github.com/devlikeapro/waha/releases
- WAHA documentation: https://waha.devlike.pro/docs/overview/introduction/
- Template repo (Dockerfile, changelog): https://github.com/aalfath/waha-railway-template
Implementation Details
After the deploy finishes:
- Open
https://YOUR-DOMAIN/dashboardand sign in asadminwithWAHA_DASHBOARD_PASSWORDfrom the service's Variables tab. - Add the server in the dashboard with the URL
https://YOUR-DOMAINand theWAHA_API_KEYvalue. - Start the
defaultsession and scan the QR code in WhatsApp under Linked devices. WAHA Core runs one session, nameddefault.
Every API call needs the header X-Api-Key: YOUR-API-KEY. Swagger docs are at https://YOUR-DOMAIN/ with the dashboard login. To receive messages, add WHATSAPP_HOOK_URL and WHATSAPP_HOOK_EVENTS (for example message,session.status) as service variables. WAHA is not affiliated with WhatsApp; follow WhatsApp's terms to avoid having the number banned.
Why Deploy WAHA on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying WAHA on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
