--- title: "Deploy WhatsDesk — Self-Hosted WhatsApp Marketing Platform" description: "Self-host WhatsDesk: WhatsApp campaigns & contacts. Own your data." category: "Automation" url: https://railway.com/deploy/whatsdesk-whatsapp-marketing --- # Deploy WhatsDesk — Self-Hosted WhatsApp Marketing Platform Self-host WhatsDesk: WhatsApp campaigns & contacts. Own your data. **[Deploy WhatsDesk — Self-Hosted WhatsApp Marketing Platform on Railway](https://railway.com/template/whatsdesk-whatsapp-marketing)** - **Creator:** SilverBanana - **Category:** Automation - **Total deploys:** 1 ## Template content ### WhatsDesk https://mobidonia.com/wp-content/uploads/demo/icons/WhatsDesk_logo.svg - **Image:** mobidonia/whatsdesk ### MySQL https://devicons.railway.app/i/mysql.svg - **Image:** mysql:9.4 - **Start command:** `docker-entrypoint.sh mysqld --innodb-use-native-aio=0 --disable-log-bin --performance_schema=0 --innodb-buffer-pool-size=1G` ## Documentation # Deploy and Host WhatsDesk on Railway WhatsDesk is an open-source WhatsApp marketing and automation platform — manage conversations, organize contacts, build campaigns, and run broadcasts from a single self-hosted dashboard. Instead of paying per-message on a SaaS marketing tool, connect your own WhatsApp and run contact management, bulk messaging, and campaign workflows on infrastructure you own. Hosted WhatsApp marketing tools charge monthly subscriptions plus per-message fees. WhatsDesk self-hosted on Railway costs ~$5–10/month flat — your contacts, campaigns, and conversation data stay on your own instance. --- ## What This Template Deploys | Service | Purpose | |---|---| | **WhatsDesk** | The marketing platform — conversation inbox, contact management, campaign builder, and broadcast tools | | **Database (MySQL/PostgreSQL)** | Persistent storage for contacts, conversations, campaigns, and message history | Services connect over Railway's private network with credentials injected automatically. Connect your WhatsApp through the dashboard and manage contacts and campaigns from the web UI. --- ## About Hosting WhatsDesk WhatsDesk is a self-hosted alternative to paid WhatsApp marketing SaaS — it puts campaign management, a contact database, and a shared conversation inbox on your own server. Running it means a persistent web app, a database, and a public HTTPS endpoint. This template wires the app and database on Railway with nothing to configure by hand. > **Account-safety note:** WhatsApp marketing and bulk-broadcast automation carry real risk. > Meta actively detects and bans accounts sending unsolicited bulk messages or automating a > personal account. Use a dedicated number you can afford to lose, warm it up gradually, only > message contacts who opted in, and respect WhatsApp's business policies. For high-volume > sanctioned sending, use the official WhatsApp Business API. This risk is inherent to WhatsApp > marketing tools, not specific to this template. Typical cost: **~$5–10/month** on Railway's Hobby plan for the app and database. WhatsDesk is open source — you pay only compute, with no per-message or per-contact SaaS fees. --- ## Deploy in Under 5 Minutes 1. Click **Deploy on Railway** — WhatsDesk and its database build automatically (~3–4 minutes) 2. Database credentials are auto-injected via Railway reference variables 3. Set your app URL and admin credentials in the Variables tab 4. Open your Railway URL and complete the setup, then create your admin account 5. Connect WhatsApp through the dashboard and import or add your contacts No SSH. No database setup. No server administration. --- ## Common Use Cases - **Self-hosted WhatsApp marketing platform** — run campaigns and broadcasts to opted-in contacts without a per-message SaaS subscription - **Contact and conversation management** — organize contacts, tag segments, and handle conversations from a shared inbox instead of a personal phone - **Campaign and broadcast workflows** — build message campaigns to contact segments and track them from one dashboard - **Small-business customer messaging** — manage customer conversations on a dedicated business number with your team, on infrastructure you control - **Own your marketing data** — keep contacts, message history, and campaign data in your own database rather than a third-party marketing cloud - **Pair with an API gateway** — combine WhatsDesk's campaign UI with a WhatsApp API gateway for programmatic sending alongside managed campaigns --- ## Configuration | Variable | Required | Description | |---|---|---| | `APP_URL` | ✅ Required | Your Railway public domain — required for correct links and callbacks | | `APP_KEY` | ✅ Required | Application encryption key — generate a secure random value | | `DB_HOST` | ✅ Auto-injected | Database host via Railway reference variable | | `DB_DATABASE` | ✅ Auto-injected | Database name from the Railway database service | | `DB_USERNAME` | ✅ Auto-injected | Database user via Railway reference variable | | `DB_PASSWORD` | ✅ Auto-injected | Database password via Railway reference variable | | `ADMIN_EMAIL` | Recommended | Initial admin account email | | `ADMIN_PASSWORD` | Recommended | Initial admin password — set a strong value before deploying | | `PORT` | Auto-set | Railway injects the port automatically | > Verify the exact variable names against the WhatsDesk repository before publishing — app > frameworks differ in their config keys. Set `APP_URL` to your Railway domain so links resolve, > and protect the admin account with strong credentials before exposing the URL. --- ## WhatsDesk vs. Alternatives | | WhatsDesk (Railway) | WhatsApp marketing SaaS | Official WhatsApp Business API | Personal WhatsApp | |---|---|---|---|---| | **Monthly cost** | ~$5–10 flat | Subscription + per-message | Per-conversation fees | Free | | **Self-hosted** | ✅ Yes | ❌ No | ⚠️ Via providers | ❌ No | | **Campaign / broadcast tools** | ✅ Built-in | ✅ Yes | ⚠️ Build yourself | ❌ Manual | | **Contact management** | ✅ Built-in | ✅ Yes | ⚠️ Build yourself | ❌ Basic | | **Data ownership** | ✅ Your database | ❌ SaaS servers | ⚠️ Provider | ✅ On device | | **Ban-risk (bulk sending)** | ⚠️ Real — see note | ⚠️ Varies | ✅ Sanctioned | ⚠️ High if automated | | **Open source** | ✅ Yes | ❌ No | ❌ No | ❌ No | --- ## Dependencies for WhatsDesk Hosting - Railway account — Hobby plan (~$5–10/month) for the app and database - A dedicated WhatsApp number for business/marketing use (not your primary personal number) - Contacts who have opted in to receive your messages (to stay within WhatsApp policy) ### Deployment Dependencies - [WhatsDesk GitHub Repository](https://github.com/mobidonia/whatsdesk) — source and setup - [WhatsApp Business Policy](https://business.whatsapp.com/policy) — messaging rules to follow - [Railway Documentation](https://docs.railway.com) — deployment and variables ### Implementation Details This template deploys WhatsDesk with a managed database over Railway's private network, with connection credentials injected automatically. Set `APP_URL` to your Railway public domain and `APP_KEY` to a secure random value on first deploy. All contacts, conversations, campaigns, and message history persist in the database across redeploys. Because WhatsApp connections depend on a session, expect to re-authenticate if the session drops, and run a single instance to avoid session conflicts. Verify the exact environment-variable names and connection method against the WhatsDesk repository, since these can change between versions. --- ## Frequently Asked Questions **Is it safe to use for WhatsApp marketing?** There is real risk. WhatsApp/Meta actively detects and bans accounts that send unsolicited bulk messages or automate personal accounts. Use a dedicated number, warm it up gradually, message only opted-in contacts, and follow WhatsApp's business policy. For large sanctioned volumes, the official WhatsApp Business API is the compliant path. This risk applies to all WhatsApp marketing tools, not just this one. **How much does it cost to run?** About $5–10/month for the Railway app and database. WhatsDesk is open source, so there are no per-message or per-contact fees — you pay only compute, unlike SaaS marketing tools that bill per message sent. **Do I lose my contacts and campaigns if Railway redeploys?** No. All contacts, conversations, campaigns, and message history are stored in the Railway-managed database, not in the app container. Redeploys and updates don't affect your data. **How does WhatsDesk connect to WhatsApp?** Through the dashboard after deploy. Because the connection is session-based, you may need to re-authenticate if the session drops, and you should run a single instance to avoid conflicts. Check the repository for the current connection method. **Can I use this alongside a WhatsApp API gateway?** Yes. WhatsDesk handles campaign and contact management with a UI; pairing it with a WhatsApp API gateway gives you programmatic sending alongside managed campaigns. Keep both pointed at the same dedicated number and mind the combined sending volume. **Should I use my personal WhatsApp number?** No. Use a separate, dedicated number for any marketing or automation. Using your primary personal number risks losing it to a ban. A dedicated number keeps your personal account isolated from the platform's automation detection. --- ## Why Deploy and Host WhatsDesk 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 WhatsDesk on Railway, you get a self-hosted WhatsApp marketing and conversation platform — contact management, campaigns, and a shared inbox — at ~$5–10/month flat, with full ownership of your contact and campaign data and no per-message SaaS fees. ## Similar templates - [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker. - [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — [Jul'26] WhatsApp automation platform using Evolution API, n8n & PostgreSQL - [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage Open this page in a browser: https://railway.com/deploy/whatsdesk-whatsapp-marketing