ERPNext v16 Business Suite

ERPNext v16 is an open-source ERP covering accounting, inventory, selling, buying, manufacturing, projects and CRM. This template deploys it from the official Frappe image with MariaDB, two Redis services, background workers and the scheduler, and creates the site on first boot.

What you get

  • ERPNext v16 (frappe/erpnext v16.50.0) running nginx, Gunicorn, socket.io, workers and scheduler together in one service that owns the sites volume
  • MariaDB 11.8 on its own service with a volume
  • Separate Redis services for cache (no persistence) and for job queues and realtime (volume)
  • Site created and ERPNext installed automatically on first boot, with a generated Administrator password
  • Database migration runs once automatically after an image upgrade

Good for

  • Accounting, invoicing and tax for a small or mid-sized company
  • Stock, warehouses, purchasing and sales orders in one system
  • Leads, opportunities and quotations alongside fulfilment and billing
  • Manufacturing with bills of materials, work orders and production planning

Cost

Cost on Railway's usage billing is driven mainly by RAM. Idle figures measured locally right after boot were about 400 MB for ERPNext and 300 MB for MariaDB with a 256 MB buffer pool; usage grows with users and workers.

Services in this template

  • redis-queue · image redis:8.2
  • redis-cache · image redis:8.2
  • ERPNext · from baranberkay96/erpnext-railway
  • MariaDB · image mariadb:11.8.9

Questions people ask

How do I log in for the first time?

Wait for the first deploy to finish, since site creation takes a few minutes. Open the public URL and sign in as Administrator with the generated ADMIN_PASSWORD from the ERPNext service variables. Then complete the setup wizard, change the password and create your users.

Is my data kept across redeploys?

Yes. The sites folder, MariaDB and the queue Redis each use a volume. The cache Redis has no persistence by design. Railway volume backups cover the sites and MariaDB volumes, and you can also run bench backup --with-files from a Railway shell.

How do I upgrade ERPNext?

Change the ERPNEXT_VERSION build argument within the v16 line and redeploy. The database migration runs automatically once.

Can I run more than one replica?

No. The ERPNext service owns the sites volume, so it runs as a single replica. To scale, raise the worker and Gunicorn settings and give the service more memory.

Does it include payroll or HR?

No. Frappe HR (payroll, leave, attendance) is a separate app and is not included in this image.

Full template README

Deploy and Host ERPNext with Railway

ERPNext is an open-source ERP built on the Frappe framework, covering accounting, inventory, selling, buying, manufacturing, projects and CRM. This community template deploys ERPNext v16 from the official Frappe image on Railway with MariaDB, separate cache and queue Redis, background workers and the scheduler, and creates your site automatically.

About Hosting ERPNext

An ERPNext install consists of a Gunicorn web server, a socket.io realtime server, background workers for short and long jobs, a scheduler, and nginx for static assets, plus MariaDB and two Redis instances. All Frappe processes must share the same sites folder, and a Railway volume belongs to a single service, so this template runs those processes together under supervisord in one service that owns the sites volume, while MariaDB and Redis run as their own services. On first boot it creates the site, installs ERPNext, enables the scheduler and sets a generated Administrator password. After an image upgrade it runs the database migration once.

Common Use Cases

  • Running accounting, invoicing and tax for a small or mid-sized company
  • Managing stock, warehouses, purchasing and sales orders in one system
  • Tracking leads, opportunities and quotations alongside fulfilment and billing
  • Manufacturing with bills of materials, work orders and production planning

Dependencies for ERPNext Hosting

  • ERPNext / Frappe (official frappe/erpnext:v16.50.0 image, extended with supervisord)
  • MariaDB 11.8
  • Redis for cache
  • Redis for job queues and realtime pub/sub

Deployment Dependencies

Implementation Details

Service Image Role
ERPNext built from services/erpnext (frappe/erpnext:v16.50.0 + supervisord) nginx, Gunicorn, socket.io, short and long workers, scheduler; owns the sites volume
MariaDB mariadb:11.8.9 Database (volume)
redis-cache redis:8.2 Cache (no persistence)
redis-queue redis:8.2 Job queues and realtime (volume)

First login: wait for the first deploy to finish (site creation takes a few minutes), open the public URL and sign in as Administrator with the generated ADMIN_PASSWORD shown in the ERPNext service variables. Complete the setup wizard, then change the password and create your users.

Scaling: raise WORKER_SHORT_PROCS, WORKER_LONG_PROCS, GUNICORN_WORKERS or GUNICORN_THREADS and give the ERPNext service more memory. The service cannot run multiple replicas because it owns the sites volume. Raise MARIADB_INNODB_BUFFER_POOL_SIZE as your data grows.

Versions: the ERPNext version is the ERPNEXT_VERSION build argument in services/erpnext/Dockerfile. Change it within the v16 line and redeploy; the migration runs automatically once.

Frappe HR (payroll, leave, attendance) is a separate app and is not included in this image.

Why Deploy ERPNext on Railway?

Railway provides the database, Redis services, persistent volumes and HTTPS domain in one project, so a complete ERPNext install comes up from a single template without server administration. You pay for the resources the ERP actually uses and can resize each service as your company grows.

Guides for this template

View ERPNext v16 Business Suite on railway.com

Similar templates

TemplateCategoryDeploymentsDeploys
Chatwoot
A customer communication platform
Other5,871
Ubuntu-Linux
Ubuntu terminal accessible via web browser
Other4,926
Ubuntu SSH + Claude
ARA TM —SSH server with root access + Claude Code pre-installed.
Other4,682
Debian-Linux
Debian terminal accessible via web browser.
Other2,883
Code Server
VS Code in the browser
Other2,787
Kali Linux (Web Terminal)
Instant Kali Linux browser terminal powered by ttyd
Other2,632