Deploy Frappe CRM

Open-source CRM by the ERPNext team: web, worker, scheduler, MariaDB, Redis

Deploy Frappe CRM

Redis-Cache

redis:8.2

Just deployed

/data

/home/frappe/frappe-bench/sites

Just deployed

/var/lib/mysql

Redis-Queue

redis:8.2

Just deployed

/data

Deploy and Host Frappe CRM on Railway

Frappe CRM is an open-source customer relationship manager from the team behind ERPNext. It tracks leads, deals, contacts and organizations in a fast kanban and list interface, with email, notes, tasks, call logging (Twilio, Exotel) and SLA rules. It runs on the Frappe Framework and is licensed AGPL-3.0.

About Hosting Frappe CRM

Frappe CRM is not a single container. It needs a Python web server, a background worker, a scheduler, a Node.js Socket.IO server for realtime updates, MariaDB with Frappe's character-set settings, and two Redis instances (cache and queue). The site must be created once with bench new-site, and every upgrade needs bench migrate. The upstream image ships only the framework, so the CRM app has to be installed into it. This template wires all of that over Railway's private network, generates every password, creates the site on first start, runs migrations on upgrade, and keeps the site files and database on volumes.

Common Use Cases

  • Sales pipeline for a small or mid-sized team: leads, deals, kanban stages and follow-up tasks
  • Self-hosted alternative to HubSpot, Pipedrive or Salesforce, with your data in your own database
  • Shared inbox and call log for customer conversations, linked to each lead or deal

Dependencies for Frappe CRM Hosting

  • MariaDB 11.8 (bundled, on a volume)
  • Redis for cache and Redis for the job queue (bundled, Railway Redis)

Deployment Dependencies

Implementation Details

Services in this template:

  • frappe-crm (public): nginx, gunicorn and one background worker for all queues. Creates the site on first start and runs bench migrate after an update. Site files on a volume.
  • websocket: Frappe's Socket.IO server for realtime updates, proxied at /socket.io.
  • scheduler: queues CRM's periodic jobs for the worker.
  • MariaDB: database, pinned mariadb:11.8.9 with the charset flags Frappe needs, on a volume.
  • Redis-Cache and Redis-Queue: Railway Redis, each on a volume.

After deploy: the first start takes about 5 minutes while the site is created (the URL shows a holding page). Then open the frappe-crm domain and sign in as Administrator with the generated ADMIN_PASSWORD variable of the frappe-crm service. The CRM is at /crm and Frappe's admin desk at /app. Set up email and calling inside the CRM's settings. WhatsApp needs Frappe's separate WhatsApp app, which this template does not include.

Updates: the app services build from a public GitHub repo, so Railway offers you an update when the template moves to a new release. Read the repo's CHANGELOG, back up MariaDB and the frappe-crm volume, then apply it; bench migrate runs on the next start.

Why Deploy Frappe CRM 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 Frappe CRM 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 Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0