Deploy Helpdesk
Frappe Helpdesk ticketing: web, websocket, scheduler, MariaDB, two Redis
MariaDB
Just deployed
/var/lib/mysql
Redis-Queue
Just deployed
/data
Redis-Cache
Just deployed
Just deployed
/home/frappe/frappe-bench/sites
Websocket
Just deployed
Scheduler
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
- Frappe Helpdesk v16.2.0 release
- Official ghcr.io/frappe/helpdesk image
- frappe_docker, the upstream container setup
- Template repository with the Dockerfiles and start scripts
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
sitesfolder. On first start it creates the site and theAdministratoruser. When an update changes the app versions, it runsbench migrate. - Websocket: Frappe's socket.io server. Nginx forwards
/socket.ioto 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.6with 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
MariaDB
mariadb:11.8.9Redis-Queue
redis:8.2.6Redis-Cache
redis:8.2.6Websocket
aalfath/helpdesk-railway-templateScheduler
aalfath/helpdesk-railway-template