--- title: "Deploy OpenWA (w/ Dashboard, Postgres, Redis and MinIO)" description: "Deploy OpenWA on Railway. WhatsApp REST API. One click." category: "Bots" url: https://railway.com/deploy/openwa-w-dashboard-postgres-redis-and-mi --- # Deploy OpenWA (w/ Dashboard, Postgres, Redis and MinIO) Deploy OpenWA on Railway. WhatsApp REST API. One click. **[Deploy OpenWA (w/ Dashboard, Postgres, Redis and MinIO) on Railway](https://railway.com/template/openwa-w-dashboard-postgres-redis-and-mi)** - **Creator:** RBR Digital - **Category:** Bots - **Total deploys:** 26 ## Template content ### MinIO https://cdn.prod.website-files.com/681c8426519d8db8f867c1e8/681c8426519d8db8f867c1f2_favicon-32x32.png - **Image:** minio/minio - **Start command:** `minio server /data --console-address ":9001"` ### Postgres https://devicons.railway.app/i/postgresql.svg - **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18 ### OpenWA Dashboard https://www.open-wa.org/assets/openwa_logo.webp - **Image:** ghcr.io/douglasrubims/openwa-dashboard: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"` ### OpenWA API https://www.open-wa.org/assets/openwa_logo.webp - **Image:** ghcr.io/rmyndharis/openwa:latest - **Public domain:** Yes ## Documentation # Deploy and Host OpenWA on Railway [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/Y7Uecc?referralCode=9uHSFr&utm_medium=integration&utm_source=template&utm_campaign=generic) OpenWA is an open-source WhatsApp automation platform built on top of WhatsApp Web. Connect personal or business WhatsApp accounts through a REST API to send messages, manage chats, receive webhooks, and automate workflows without requiring Meta Business API approval. ## About Hosting OpenWA Hosting OpenWA on Railway requires persistent storage for WhatsApp authentication sessions, media files, plugins, and database data. This template provisions a complete OpenWA stack including PostgreSQL, Redis, MinIO object storage, and the OpenWA Dashboard. This template uses the prebuilt Docker images: ```txt ghcr.io/rmyndharis/openwa:latest ghcr.io/douglasrubims/openwa-dashboard:latest ``` Railway provisions networking, SSL, deployments, private networking, and persistent storage automatically. ## Common Use Cases - WhatsApp chatbots and automation - Customer support integrations - Workflow automation with webhooks - Notifications and alerts - Multi-session WhatsApp management - Media storage and automation pipelines ## Dependencies for OpenWA Hosting - Persistent volume (mount path: `/app/data`) - PostgreSQL database - Redis cache - MinIO S3-compatible object storage - OpenWA Dashboard ### Deployment Dependencies - [OpenWA GitHub](https://github.com/rmyndharis/OpenWA) - [Railway Documentation](https://docs.railway.com) ### Implementation Details **OpenWA Docker image:** ```txt ghcr.io/rmyndharis/openwa:latest ``` **Dashboard Docker image:** ```txt ghcr.io/douglasrubims/openwa-dashboard:latest ``` **Environment variables** (use Railway reference syntax when deploying): | Variable | Value | | ---------------------- | ----------------------------------------------------------------------------- | | `NODE_ENV` | `production` | | `API_PORT` | `2785` | | `LOG_LEVEL` | `info` | | `DATABASE_TYPE` | `postgres` | | `DATABASE_HOST` | `${{Postgres.PGHOST}}` | | `DATABASE_PORT` | `${{Postgres.PGPORT}}` | | `DATABASE_USERNAME` | `${{Postgres.PGUSER}}` | | `DATABASE_PASSWORD` | `${{Postgres.PGPASSWORD}}` | | `DATABASE_NAME` | `${{Postgres.PGDATABASE}}` | | `DATABASE_SYNCHRONIZE` | `false` | | `ENGINE_TYPE` | `whatsapp-web.js` | | `SESSION_DATA_PATH` | `/app/data/sessions` | | `STORAGE_TYPE` | `s3` | | `STORAGE_LOCAL_PATH` | `/app/data/media` | | `S3_ENDPOINT` | `http://${{MinIO.RAILWAY_PRIVATE_DOMAIN}}:9000` | | `S3_ACCESS_KEY` | `${{MinIO.MINIO_ROOT_USER}}` | | `S3_SECRET_KEY` | `${{MinIO.MINIO_ROOT_PASSWORD}}` | | `S3_BUCKET` | `openwa` | | `REDIS_ENABLED` | `true` | | `REDIS_HOST` | `${{Redis.RAILWAY_PRIVATE_DOMAIN}}` | | `REDIS_PORT` | `6379` | | `PLUGINS_ENABLED` | `true` | | `PLUGINS_DIR` | `/app/data/plugins` | | `PUPPETEER_HEADLESS` | `true` | | `PUPPETEER_ARGS` | `--no-sandbox,--disable-setuid-sandbox,--disable-dev-shm-usage,--disable-gpu` | **Dashboard Environment Variables:** | Variable | Value | | ---------------- | --------------------------------------- | | `OPENWA_HOST` | `${{OpenWA.RAILWAY_PRIVATE_DOMAIN}}` | **Initial API Key:** OpenWA automatically generates an API key during the first startup and prints it in the OpenWA API deployment logs. After deployment: 1. Open the `OpenWA API` service in Railway. 2. Go to `Deploy Logs`. 3. Copy the generated API key. 4. Open the Dashboard URL. 5. Paste the API key when prompted. API keys can later be managed from inside the Dashboard or through the API. **OpenWA Volume:** Mount `/app/data` for persistent WhatsApp sessions, plugins, SQLite fallback database, and media files. **MinIO Volume:** Mount `/data` for persistent object storage. **MinIO Start Command:** ```bash minio server /data --console-address ":9001" ``` **Redis Start Command:** ```bash redis-server --appendonly yes ``` **OpenWA Public Port:** `2785` **Dashboard Public Port:** `80` **Quick start (local):** ```bash docker run -p 2785:2785 \ -v openwa-data:/app/data \ ghcr.io/rmyndharis/openwa:latest ``` API available at: ```txt http://localhost:2785 ``` ## Why Deploy OpenWA on Railway? Railway provides a simple way to deploy and scale OpenWA without managing servers, reverse proxies, SSL certificates, databases, cache infrastructure, object storage, or frontend hosting manually. By deploying OpenWA on Railway, you can run a complete WhatsApp automation infrastructure with PostgreSQL, Redis, MinIO, Dashboard, persistent storage, public networking, and automated deployments in minutes while focusing on your integrations and workflows instead of infrastructure management. --- ## 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 real-time WebSocket event streaming Open this page in a browser: https://railway.com/deploy/openwa-w-dashboard-postgres-redis-and-mi