Evolution API on Railway
Open-source WhatsApp REST API with a Manager UI, Postgres and Redis, self-hosted on Railway.
Evolution API is an open-source REST API for WhatsApp. You connect a phone number by QR code, then send and receive messages, manage groups and contacts, and push events to webhooks or to tools such as n8n, Chatwoot and Typebot.
Each instance keeps a long-lived WhatsApp Web connection for one phone number. Instances, credentials, messages and contacts are stored in Postgres, and Redis is used for cache and session keys. A built-in Manager UI lets you create and inspect instances.
It is licensed under Apache-2.0 with additional conditions: the logo and copyright in the Manager must stay, and a notice that Evolution API is used must be visible to administrators. It is not an official WhatsApp or Meta product.
What Evolution API can do
- Connect a WhatsApp number by QR code
- Send and receive messages through a REST API
- Groups and contacts management
- Webhook events for messages, status and connection
- Integrations with n8n, Chatwoot, Typebot and similar tools
- Manager UI protected by the global API key
What people use it for
- Order updates and appointment reminders sent from your backend
- A WhatsApp number as a shared support inbox in Chatwoot
- Bots triggered by incoming WhatsApp messages
- Receiving WhatsApp events as webhooks in your app
Videos
Running Evolution API on Railway
The Railway template deploys the Evolution API service together with Postgres and Redis, each with a volume, wired over the private network. The API listens on one public HTTPS domain, every endpoint requires a generated global API key, and the Manager UI at /manager asks for the same key. The service applies database migrations on start. Railway bills the CPU, memory and volumes of the three services.
Evolution API templates on Railway
Tracklayer templates are listed first. Other Evolution API templates follow, ordered by total deployments on Railway. How this works.
Deployment numbers as of 2026-11-20.
Questions about Evolution API
How do I log in to the Manager?
Open /manager on the deployed domain and enter the global API key that the template generated. The same key is required for every API request.
Can I use it commercially?
The licence is Apache-2.0 with two extra conditions: keep the logo and copyright in the Manager, and show a notice that Evolution API is used. If they are not met, a commercial licence from the producer may be required. Read the licence text for your case.
How many phone numbers can I connect?
One instance is one phone number. You can create several instances in the same deployment.
What should I back up?
The Postgres database and the instance data volume. They hold instances, credentials, messages and contacts.
Is it affiliated with WhatsApp?
No. Evolution API is an independent project, and the Railway template is a community package that is not affiliated with Evolution Foundation, Meta or WhatsApp.
Guides
Tracklayer maintains the templates marked as such; Evolution API is a trademark of its owners and this site is not affiliated with them.
