Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Self-host ERPNext
updated Sep 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
ERPNext is a GPL-3.0 open-source ERP from Frappe covering accounting, order management and inventory, manufacturing, asset management and projects, built on the MIT-licensed Frappe Framework. There is no paid edition of the software — Frappe sells managed hosting (Frappe Cloud), not features. HR and payroll live in a separate GPL-3.0 app, Frappe HR. It self-hosts through the official frappe_docker stack: MariaDB, two Redis instances, the web backend, background workers, a scheduler and a websocket service.
Pick ERPNext when you want a full ERP on free software: it is GPL-3.0 with no paid edition, and accounting (general ledger, bank reconciliation, budgets), order management and inventory, manufacturing, asset management and projects are all in the free product. HR and payroll are a separate GPL-3.0 app, Frappe HR, split out of ERPNext at version 14. Upstream's production route is the Easy Install script from frappe/bench, which installs Docker and deploys the official frappe_docker stack; frappe_docker's single-server guide recommends 2 vCPU, 4 GB of RAM and 50 GB of SSD, which is where our 4 GB floor sits. If your needs fit Odoo Community's free apps and you want a two-container install, Odoo is the simpler alternative in this catalog.
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# ERPNext — official Easy Install script (frappe/bench), which deploys frappe_docker with Traefik for automatic HTTPS, per our ERPNext deploy guide# needs a domain pointed at this server and ports 80/443 open; replace both values — the email must be real (Let's Encrypt rejects example.com)DOMAIN=erp.example.comEMAIL=admin@yourdomain.com# run in a dedicated directory: the script downloads frappe_docker into the current one and writes its files to $HOMEmkdir -p ~/erpnext && cd ~/erpnextwget -q https://raw.githubusercontent.com/frappe/bench/develop/easy-install.pypython3 easy-install.py deploy --email="$EMAIL" --sitename="$DOMAIN" --app=erpnext# installs Docker, pulls ~5 GB of images (several minutes) and creates the site; it exits 0 even if site creation fails, so check https://DOMAIN/api/method/ping answers pongchmod 600 ~/frappe.env ~/frappe-compose.yml ~/frappe-passwords.txt# the Administrator and MariaDB root passwords are in ~/frappe-passwords.txt; the scheduler starts disabled, so enable it once:docker compose -p frappe exec backend bench --site "$DOMAIN" enable-scheduler
ERPNext's licence is simple; running it is where the work is, and frappe_docker's own docs spell out the traps:
non-negotiableIt is a stack, not a container. A frappe_docker deployment is the backend, an nginx frontend, a websocket service, a scheduler and short and long queue workers, plus MariaDB and Redis added through its compose overrides — and the one-file pwd.yml quick start is a disposable demo that upstream says is not for production. Use the Easy Install script or compose.yaml with its overrides for anything real.
non-negotiableApps are baked into the image. Installing an app into a running container (bench get-app, bench build) is not supported; adding Frappe HR or any other app later means adding it to the image build, rebuilding and redeploying. Decide which apps you need before you go live.
non-negotiableSize for the database, not the demo. frappe_docker's 4 GB is a starting point for one server; Frappe's database-tuning guide suggests starting a database server at 8 GB of RAM and 50 GB of disk, and scaling vertically as usage grows. Your books live in that database, so back it up off the server and test a restore.
ERPNext used 832 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 4096 MB.
Is the ERPNext install snippet verified?
The ERPNext install snippet is marked verified on Ubuntu 26.04 (Nov 2026).