[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

frappe-nix

Reproducible Nix infrastructure for Frappe and ERPNext, from the development shell to OCI containers and a multi-site NixOS module.

[Open source](/open-source/)

frappe-nix

NixOSActiveMIT

[View on GitHub (opens in a new tab)](https://github.com/Avunu/frappe-nix)[Documentation (opens in a new tab)](https://docs.avunu.net/frappe-nix/)

PlatformNixOS

LicenseMIT

StatusActive

Repository[Avunu/frappe-nix](https://github.com/Avunu/frappe-nix)

Part ofThe Nix platform

Used in[Textile & home-decor printing](/work/textile-print-shop/), [Timber-frame structures manufacturing](/work/timber-frame-manufacturer/), [Professional services](/work/avunu-erp/)

Setting up a Frappe bench by hand is slow, and no two benches end up quite alike. frappe-nix describes the whole thing declaratively, so the bench a developer runs, the one CI tests, and the one in production are built from the same pinned inputs. Your project's own flake stays a short wrapper. It's for Frappe and ERPNext developers and for teams that self-host and want deploys they can reproduce.

## Features

**Scaffolding.**`nix run github:Avunu/frappe-nix` creates a new bench with a chosen Frappe version and apps, migrates an existing bench in place, or sets up app mode for a single app's repository.

**Development shell.** MariaDB, Redis, the Frappe runtime, asset watching, and Mailpit through devenv, with editable Python installs.

**Guard rails.** A bench restored from a production backup can't send real mail, delete from the production bucket, upload backups, fire webhooks, or sync with Plaid or Google. Local backups keep working.

**Reproducible builds.** Python environments through uv2nix, `node_modules` from each app's own `yarn.lock`, and a `builtBench` package with compiled assets.

**Production.** OCI images (a single runtime or split web, worker, scheduler, and socketio images) and a multi-tenant `services.frappe` NixOS module with per-site systemd units, secrets kept out of the Nix store, and safe migrations on deploy.

**Bench scripts** such as `provision-site`, `bench-update`, and `bench-get-app`.

## Getting started

You need Nix with flakes and direnv. Run the scaffolder, then follow the [quick start in the README](https://github.com/Avunu/frappe-nix#quick-start):

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">direnv</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">allow</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># or: nix develop --no-pure-eval</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">devenv</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">up</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">               </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># start MariaDB, Redis, the Frappe runtime, watch, …</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">provision-site</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">          </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># (first run, in another shell) create the site + install apps</span>
```

Highlights

One command to scaffold a bench or set up a single app repodevenv shell with MariaDB, Redis, Mailpit, and live reloadGuard rails so a restored production copy can't mail customersReproducible Python and Node environments with built assetsOCI images and a multi-tenant services.frappe NixOS module

Related projects

[All open-source projects](/open-source/)

[odoo-nix](/open-source/odoo-nix/)

Active

Reproducible Nix infrastructure for Odoo Community (OCB) and OCA, from scaffolding projects and addon repositories to repository standards, CI, containers, and NixOS.

MIT[GitHub](https://github.com/Avunu/odoo-nix)

[wordpress-nix](/open-source/wordpress-nix/)

Active

A fast FrankenPHP WordPress stack built with Nix, deployable as OCI containers or a NixOS module, with MySQL, Cloudflare D1, or Turso databases.

MIT[GitHub](https://github.com/Avunu/wordpress-nix)

[Web Kiosk](/open-source/web_kiosk/)

Stable

A USB-booting NixOS image that turns an x86 computer into a locked-down Firefox kiosk for a single web page.

MIT[GitHub](https://github.com/Avunu/web_kiosk)

Need help with it?

Need this implemented? We host Frappe and ERPNext on this platform as managed infrastructure.

[Explore managed infrastructure](/services/infrastructure/)[Start a project](/start/)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
