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

Click Deploy on Railway — WhatsDesk and its database build automatically (~3–4 minutes)
Database credentials are auto-injected via Railway reference variables
Set your app URL and admin credentials in the Variables tab
Open your Railway URL and complete the setup, then create your admin account
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 — source and setup
WhatsApp Business Policy — messaging rules to follow
Railway Documentation — 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.