---
title: "Deploy Evolution API"
description: "Deploy Evolution API on Railway. WhatsApp REST API. One click."
category: "Bots"
url: https://railway.com/deploy/evolution-api-4
---

# Deploy Evolution API

Deploy Evolution API on Railway. WhatsApp REST API. One click.

**[Deploy Evolution API on Railway](https://railway.com/template/evolution-api-4)**

- **Creator:** RBR Digital
- **Category:** Bots
- **Total deploys:** 5,462

## Template content

### Evolution API https://evolutionfoundation.com.br/favicon.png

- **Image:** evoapicloud/evolution-api:latest
- **Public domain:** Yes

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2.1
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:17

## Documentation

# Deploy and Host Evolution API on Railway

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/vArFEN?referralCode=9uHSFr&utm_medium=integration&utm_source=template&utm_campaign=generic)

Evolution API is an open-source WhatsApp REST API built on Baileys. Connect a personal WhatsApp account via HTTP endpoints without Meta's Business API approval. Send messages, manage groups, receive webhooks, and automate workflows—all through a simple REST interface.

## About Hosting Evolution API

Hosting Evolution API requires a PostgreSQL database for persistence (instances, messages, contacts, chats), Redis for cache and session management, and a persistent volume for WhatsApp instance authentication data. The API listens on port 8080 and exposes REST endpoints for instance creation, QR code connection, messaging, and webhook configuration. Railway provisions all services and handles networking, SSL, and scaling.

## Common Use Cases

- Chatbots and conversational automation
- Notifications, alerts, and broadcast messaging
- Customer support and helpdesk integration
- Multi-instance WhatsApp management for agencies

## Dependencies for Evolution API Hosting

- PostgreSQL (persistence for instances, messages, contacts, chats)
- Redis (cache and session management)
- Persistent volume (mount path: `/evolution/instances` for auth data)

### Deployment Dependencies

- [Evolution API Documentation](https://doc.evolution-api.com)
- [Evolution API GitHub](https://github.com/EvolutionAPI/evolution-api)
- [Railway Documentation](https://docs.railway.app)

### Implementation Details

**Environment variables** (use Railway reference syntax when deploying):

| Variable | Value |
|----------|-------|
| `DATABASE_PROVIDER` | `postgresql` |
| `DATABASE_CONNECTION_URI` | `${{Postgres.DATABASE_URL}}` |
| `CACHE_REDIS_URI` | `${{Redis.REDIS_URL}}` |
| `CACHE_REDIS_ENABLED` | `true` |
| `SERVER_URL` | `https://${{RAILWAY_PUBLIC_DOMAIN}}` |
| `AUTHENTICATION_API_KEY` | `${{secret(64, "abcdef0123456789")}}` |

**Volume:** Mount `/evolution/instances` for persistent instance data.

**Quick start (local):** `cp .env.example .env` then `docker compose up -d`. API at `http://localhost:8080`.

## Why Deploy Evolution API 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 Evolution API 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 Author

Created and maintained by **Douglas Rubim**.

GitHub: https://github.com/douglasrubims

## Similar templates

- [Telegram JavaScript Bot](https://railway.com/deploy/5lRkWa) — A template for Telegram bot in JavaScript using grammY
- [Cobalt Tools [Updated Aug ’26]](https://railway.com/deploy/cobalt) — Cobalt Tools [Aug ’26] (Media Downloader, Converter & Automation) Self Host
- [Telegram Gateway](https://railway.com/deploy/railway-telegram-gateway) — Multi-bot Telegram webhook gateway with WebSocket event streaming

Open this page in a browser: https://railway.com/deploy/evolution-api-4