mrkeyoor.com_
Tue 01 Sept 17:43 UTC
Self-Hostedevaluationupdated 26 Aug 2026

erpnext review

ERPNext is a self-hosted business system for accounting, inventory, sales, purchasing, manufacturing, assets, projects, and staff records. It replaces several disconnected back-office tools with one database and workflow layer built on the Frappe Framework.

+209stars / 7d
Verdict

Our ERPNext checkout installed 470 packages in 103 seconds, then its build failed in 5 seconds because /sites/common_site_config.json was missing. Use ERPNext when its business modules fit and you can treat Frappe operations and implementation work as part of the purchase. Do not choose it because the disposable Docker demo looks easy; production is a managed system, not that demo with better passwords.

We ran it

Install✓ · 103s470 packages · 320 MB
Build✗ · 5s
Testsn/ano test script
Repo5544 files~507,484 lines of source · 144.7 MB · 23 CI workflows

Answers from our run

Does erpnext build from source?

Dependencies installed in 103 seconds (470 packages), and the build failed. We cloned commit 8d2aa69 into a clean Debian container with 3 CPUs and no project-specific setup.

Does erpnext have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Who should not use erpnext?

A small team seeking a single-container accounting app: the README routes self-hosting through a separate Frappe Docker project, and manual development starts with Bench plus a new site.

What are the alternatives to erpnext?

Odoo, Dolibarr, metasfresh. Our ERPNext checkout installed 470 packages in 103 seconds, then its build failed in 5 seconds because `/sites/common_site_config.

Setup2/5470 packages installed; isolated build needed Frappe site config
Docs4/5Clear routes for demo, hosting, Docker, Bench, and learning
Community5/538,519 stars and active issue and pull request work
Maturity5/5v16.33.0 shipped amid daily development activity

Discussed on

  1. hnERPNext: Free and Open Source Enterprise Resource Planning23 points
  2. hnERPNext and Frappé5 points
  3. hnErpnext: Free and open source ERP3 points
  4. hnERPNext: Open Source ERP3 points

Who it’s for

Organizations that want accounting, stock, orders, manufacturing, and projects in one self-hosted system.
Teams willing to adapt business processes around Frappe documents, permissions, and workflows.
Implementers who can operate MariaDB, Redis, Bench, background workers, backups, and upgrades.
Buyers who value GPL-3.0 source access and a large service-provider community.

Who it’s NOT for

A small team seeking a single-container accounting app: the README routes self-hosting through a separate Frappe Docker project, and manual development starts with Bench plus a new site.
Companies expecting a disposable demo to become production: the README explicitly says its quick Docker setup cannot install custom apps and should be thrown away.
Operators who cannot rehearse migrations and business-rule changes: v16.33.0 includes accounting, stock, manufacturing, permission, and data-repair changes in one release.
Developers who want this checkout to build in isolation: our build stopped because /sites/common_site_config.json did not exist.

Setup reality

Our sandbox installed 470 Yarn packages in 103 seconds and used 320 MB. The build failed with exit code 1 after 5 seconds because Vite tried to open /sites/common_site_config.json, which was absent. The repository had no test script or target, so we skipped tests.

The README's manual path needs Bench, a Frappe site, MariaDB, and generated administrator and database credentials. Its self-hosted Docker route lives in frappe/frappe_docker, where the quick compose file creates a disposable site on port 8080.

This is a 5,544-file application with about 507,484 source lines, not a standalone Node package. Production also means workers, queues, backups, mail, upgrades, and business configuration. The checkout has 23 CI workflow files but no Dockerfile of its own.

ERPNext covers seven core back-office jobs in one system

ERPNext puts accounting, order management, inventory, manufacturing, assets, projects, and personnel records on the same application model. A sales order can feed stock, fulfillment, invoicing, and financial reports instead of being copied between specialist tools. That shared model is the appeal. It also means adoption reaches into how a company names items, closes periods, approves purchases, values stock, and assigns permissions. ERP software succeeds through process fit and careful implementation, not through a convincing dashboard.

The code sits on Frappe Framework, which supplies database access, authentication, permissions, forms, and a REST API. Frappe UI supplies Vue components for newer interfaces. Our checkout was correspondingly large: 5,544 files, roughly 507,484 source lines, and 144.7 MB before dependencies. Buyers get a platform they can extend with custom apps, but those extensions become part of every upgrade rehearsal and support conversation.

The 5-second build expects a Frappe site around the checkout

ERPNext's README does not present this repository as an isolated application. The manual development path first installs Bench, starts it, creates erpnext.localhost, fetches the ERPNext app, and installs that app into the site. The production section points self-hosters to the separate Frappe Docker repository. That architecture explains why evaluating only a Yarn command gives an incomplete picture, though the command's failure still identifies a real prerequisite.

Our sandbox installed 470 packages in 103 seconds and occupied 320 MB. The build stopped after 5 seconds with exit code 1. Vite attempted to open /sites/common_site_config.json, and the file did not exist. The log establishes the missing path and nothing more, so we do not attribute it to networking, permissions, or an undocumented system package. It shows that the checked-out commit did not build without surrounding Frappe site configuration.

What happened when we ran it

We cloned commit 8d2aa69 into an unprivileged Debian container with 3 CPUs, 8 GB of RAM, no secrets, and Node 22. The 144.7 MB checkout installed successfully in 103 seconds. Yarn added 470 packages and left 320 MB on disk. The repository scan found 23 CI workflow files, no Dockerfile, and no tests directory.

The build failed with exit code 1 after 5 seconds while resolving Vite configuration for the banking app. Its last lines named /sites/common_site_config.json as the missing file. No test script or test target was available, so we skipped tests rather than inventing a command. These measurements describe the supplied commit in our sandbox; they do not measure the separate Docker deployment or a configured Bench site.

The port 8080 demo is intentionally disposable

For a quick look, the README asks users to clone frappe/frappe_docker and run its pwd.yml compose file. Site creation happens in a container, and the finished demo opens on port 8080 with published administrator credentials. The warning above those commands is unusually direct: expect to throw the environment away, and do not expect to install custom apps into it. That makes the recipe useful for product evaluation and unsuitable as a production shortcut.

A real installation needs more decisions than the demo exposes. The manual script installs dependencies such as MariaDB and creates passwords for the ERPNext administrator, MariaDB root account, and Frappe user. Bench manages sites and apps. Production operators must also account for queues, workers, scheduled jobs, mail, TLS, backups, restores, monitoring, and upgrades. Managed Frappe Cloud exists largely to own that work.

v16.33.0 changes financial and operational behavior

The latest release, v16.33.0, was published on August 25, 2026. Its notes include changes to accounting permissions, exchange-rate handling, stock valuation, work orders, purchasing, sales invoices, portal escaping, and privacy behavior. Several fixes alter validation or repair existing records. That breadth is normal for an ERP, but it raises the cost of casual upgrades: finance, inventory, manufacturing, and permission scenarios need company-specific acceptance checks.

GitHub showed a push on August 26, 2026, 38,519 stars, and 1,826 open issues and pull requests. The recent activity list included both fixes and user reports, so the combined open count should not be read as a bug total. Daily development and a release from the previous day indicate active maintenance. They also mean administrators should choose a supported release line and read change notes rather than tracking the development branch.

GPL-3.0 source access does not remove implementation cost

ERPNext's GPL-3.0 license gives organizations access to the application code, and the project links to documentation, courses, a discussion forum, Telegram, contribution rules, and a translation platform. That ecosystem helps when internal staff need an answer or a specialist. It does not make accounting configuration universal. Local tax rules, charts of accounts, inventory methods, approval chains, and reporting expectations still need owners who understand the business.

ERPNext is easiest to recommend when a company wants one adaptable operating system and accepts a serious rollout. The 103-second package install was straightforward, while the missing site configuration stopped the isolated build almost immediately. Evaluate the disposable demo for workflow fit, then test a representative configured site with real roles, sample transactions, restore drills, and the exact custom apps you intend to maintain.

Alternatives

ProjectWhat it isPick it when
Odoo gh↗A broad ERP and business-app platform with open-source core code and a commercial edition.pick this instead when its app catalog, partner market, or commercial support model fits your rollout better.
DolibarrA PHP ERP and CRM aimed at smaller organizations and modular deployment.pick this instead when you need a lighter business suite and already run a conventional PHP stack.
metasfreshAn open-source ERP focused on midsize companies, logistics, and supply-chain work.pick this instead when distribution and manufacturing depth matters more than Frappe's application framework.

What people are saying

  1. [velocity-scout] frappe/erpnext

Sources

  1. ERPNext README
  2. ERPNext v16.33.0 release
  3. ERPNext repository activity
  4. ERPNext issue 58451

More self-hosted reviews

v2 · OpenShell · wigolo · Mindwtr · club-3090 · reclip · the whole board →