---
title: "Deploy Helpdesk"
description: "Frappe Helpdesk ticketing: web, websocket, scheduler, MariaDB, two Redis"
category: "Other"
url: https://railway.com/deploy/helpdesk-1
---

# Deploy Helpdesk

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

**[Deploy Helpdesk on Railway](https://railway.com/template/helpdesk-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/helpdesk-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### MariaDB https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/mariadb.png

- **Image:** mariadb:11.8.9@sha256:d36f18d65a0459510b8b0f643b226a6d299e3206486e2b64ff20754a6d291707
- **Start command:** `/bin/sh -c 'rm -rf /var/lib/mysql/lost+found; export MARIADB_AUTO_UPGRADE=1; exec docker-entrypoint.sh mariadbd --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci --skip-character-set-client-handshake --innodb-snapshot-isolation=OFF'`

### Redis-Queue https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/redis.png

- **Image:** redis:8.2.6@sha256:3055dc25265b0c19ec90a1756dad4e0faff6f79e2557a6ac3d1274e39ee906f6
- **Start command:** `/bin/sh -c 'rm -rf /data/lost+found; exec docker-entrypoint.sh redis-server --requirepass "$REDIS_PASSWORD" --appendonly yes --dir /data'`

### Redis-Cache https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/redis.png

- **Image:** redis:8.2.6@sha256:3055dc25265b0c19ec90a1756dad4e0faff6f79e2557a6ac3d1274e39ee906f6
- **Start command:** `/bin/sh -c 'exec docker-entrypoint.sh redis-server --requirepass "$REDIS_PASSWORD" --save "" --appendonly no --maxmemory 256mb --maxmemory-policy allkeys-lru'`

### Helpdesk https://raw.githubusercontent.com/frappe/helpdesk/v16.2.0/desk/public/manifest/manifest-icon-512.maskable.png

- **Source:** https://github.com/aalfath/helpdesk-railway-template
- **Health check:** /api/method/ping
- **Public domain:** Yes

### Websocket https://raw.githubusercontent.com/frappe/helpdesk/v16.2.0/desk/public/manifest/manifest-icon-512.maskable.png

- **Source:** https://github.com/aalfath/helpdesk-railway-template

### Scheduler https://raw.githubusercontent.com/frappe/helpdesk/v16.2.0/desk/public/manifest/manifest-icon-512.maskable.png

- **Source:** https://github.com/aalfath/helpdesk-railway-template

## Documentation

# 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](https://github.com/frappe/helpdesk/releases/tag/v16.2.0)
* [Official ghcr.io/frappe/helpdesk image](https://github.com/frappe/helpdesk/pkgs/container/helpdesk)
* [frappe_docker, the upstream container setup](https://github.com/frappe/frappe_docker)
* [Template repository with the Dockerfiles and start scripts](https://github.com/aalfath/helpdesk-railway-template)

### 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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/helpdesk-1
