How do I deploy Whatsmiau on Railway?

You can deploy Whatsmiau on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: whatsmiau-5cfc27e1, or click "Get template help" for this template for more assistance.

Deploy and Host WhatsMiau on Railway

WhatsMiau is a lightweight WhatsApp REST API built with Go using the Whatsmeow library. 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. Compatible with Evolution API routes for easy migration.

About Hosting WhatsMiau

Hosting WhatsMiau requires a PostgreSQL database for persistence (instances and data), Redis for session storage and caching, 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 WhatsMiau Hosting

PostgreSQL (persistence for instances and data)
Redis (session storage and caching)
Persistent volume (mount path: /app/data for auth data)

Deployment Dependencies

WhatsMiau GitHub
Evolution API Documentation (compatible routes)
Railway Documentation

Implementation Details

Environment variables (use Railway reference syntax when deploying):

Variable	Value
`DIALECT_DB`	`postgres`
`DB_URL`	`${{Postgres.DATABASE_URL}}`
`REDIS_URL`	`${{Redis.REDIS_URL}}`
`PORT`	`8080`
`API_KEY`	`${{secret(64, "abcdef0123456789")}}`

Volume: Mount /app/data for persistent instance data.

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

Why Deploy WhatsMiau 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 WhatsMiau 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.