Deploy and Host Dolibarr on Railway

Dolibarr is an open-source ERP and CRM for small and medium businesses. It covers customers and suppliers, quotes, orders, invoices, payments, products and stock, projects, expenses, HR and accounting, all in modules you switch on as you need them. It is a lighter, simpler alternative to Odoo.

About Hosting Dolibarr

This template runs the official dolibarr/dolibarr:24.0.0 image with MariaDB 11.8 as a second service. The installer runs automatically on first boot: it creates the database, the admin account from the variables, and your company with the third-party and invoicing modules enabled. Uploaded documents and generated PDFs are stored on a Railway volume, and the database on MariaDB's volume, so both survive redeploys. The start command fixes Apache's duplicate MPM modules, which otherwise stops Apache from starting on Railway. Custom modules in htdocs/custom are not persisted. Both services fit comfortably on the Hobby plan.

Common Use Cases

Quotes, invoices and payments for a small company or freelancer
A simple CRM with contacts, proposals and projects
Stock and product management without an expensive ERP

Dependencies for Dolibarr Hosting

dolibarr/dolibarr:24.0.0 (official image)
mariadb:11.8.9 (official image)
Railway volumes for documents and the database

Deployment Dependencies

Implementation Details

Service	Source	Networking	Storage
dolibarr	`dolibarr/dolibarr:24.0.0`	public domain on 80	volume at `/var/www/documents`
mariadb	`mariadb:11.8.9`	private, 3306	volume at `/var/lib/mysql`

Variable	Default	Purpose
`DOLI_ADMIN_LOGIN`	`admin`	Admin created on first boot
`DOLI_ADMIN_PASSWORD`	generated	Its password
`DOLI_COMPANY_NAME` / `DOLI_COMPANY_COUNTRYCODE`	`My Company` / `US`	Company created at install
`DOLI_ENABLE_MODULES`	`Societe,Facture,Api`	Modules enabled at install
`DOLI_INSTANCE_UNIQUE_ID`	generated	Encryption salt; keep it stable

Notes:

Change the company details under Home > Setup > Company.
Scheduled jobs need a second container with DOLI_CRON=1; see the Dolibarr Docker README.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Dolibarr project or association.

Why Deploy Dolibarr 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 Dolibarr 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.