Deploy Helpdesk

Frappe Helpdesk ticketing: web, websocket, scheduler, MariaDB, two Redis

Deploy Helpdesk

Just deployed

/var/lib/mysql

Redis-Queue

redis:8.2.6

Just deployed

/data

Redis-Cache

redis:8.2.6

Just deployed

/home/frappe/frappe-bench/sites

Just deployed

Just deployed

Deploy and Host Helpdesk on Railway

Frappe Helpdesk is an open-source customer support ticketing system from the makers of ERPNext, and an alternative to Zendesk or Freshdesk. Agents work tickets in a modern web UI with SLAs, assignment rules, canned responses and live updates, while customers use a portal and a knowledge base. It is AGPL-3.0 with no per-agent fees.

About Hosting Helpdesk

Helpdesk runs on the Frappe framework, which needs several processes from the same code: the gunicorn backend, nginx for assets and file downloads, a Node.js socket.io server for live updates, background workers and a scheduler. It also needs MariaDB with utf8mb4 settings and Redis for both the cache and the job queue. The backend and workers share a sites folder holding the site config, encryption key and attachments. A Railway volume attaches to one service only, so the backend and workers share the Helpdesk service, while the realtime server, scheduler, database and both Redis instances run as separate services over the private network.

Common Use Cases

  • Shared support inbox: turn emails to your support address into tickets that agents assign, answer and close
  • SLA-based support desk with first-response and resolution targets, priorities and escalation
  • Customer portal and knowledge base where customers open tickets and find answers themselves

Dependencies for Helpdesk Hosting

  • MariaDB 11.8 (database, with Frappe's utf8mb4 settings)
  • Redis 8.2, twice: one for the cache, one for the job queue and realtime events

Deployment Dependencies

Implementation Details

The template deploys six services. Helpdesk, Websocket and Scheduler build from the template repository, each FROM ghcr.io/frappe/helpdesk:v16.2.0 pinned by digest.

  • Helpdesk (public URL): nginx, gunicorn and a background worker for the long, default and short queues. Its volume holds the sites folder. On first start it creates the site and the Administrator user. When an update changes the app versions, it runs bench migrate.
  • Websocket: Frappe's socket.io server. Nginx forwards /socket.io to it over the private network.
  • Scheduler: runs bench schedule, which queues SLA timers, email pulls and other periodic jobs.
  • MariaDB: mariadb:11.8.9, pinned by digest, with a volume.
  • Redis-Cache: redis:8.2.6, held in memory only (256 MB, least recently used keys are evicted first).
  • Redis-Queue: redis:8.2.6 with append-only persistence on a volume.

All passwords are generated at deploy time, and the deploy form asks for nothing. The first start takes about 3 to 5 minutes, and a "Helpdesk is starting" page shows until it finishes. Then open the public URL and sign in as Administrator with the ADMIN_PASSWORD value from the Helpdesk service's Variables tab, change that password, and go to /helpdesk. Add an email account in Helpdesk's admin settings so that emails become tickets (SMTP isn't included). Updates come as Railway "update available" notices when the template repository bumps the version. Back up the MariaDB and Helpdesk volumes before you apply one.

Why Deploy Helpdesk 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 Helpdesk 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