[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/)

odoo-nix

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

[Open source](/open-source/)

odoo-nix

NixOSActiveMIT

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

PlatformNixOS

LicenseMIT

StatusActive

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

Part ofThe Nix platform

Used in[Auto & heavy-truck repair](/work/heavy-truck-repair-shop/)

Odoo Community plus OCA modules is a capable, open alternative to Odoo Enterprise, but assembling the right repositories, Python dependencies, and configuration by hand is fiddly. odoo-nix builds the whole project from a small source tree and a short flake, so development, CI, and production all run the same Odoo. It's for Odoo developers and integrators, and for businesses that want to self-host Odoo without lock-in.

## Features

**Scaffolding.**`nix run github:Avunu/odoo-nix` picks an Odoo series (18.0, 19.0, or 20.0) and, optionally, OCA bundles or individual modules from a bundled catalog. It resolves the repos those modules depend on and adds them as git submodules.

**Addon repositories.** A repository of addons, laid out the way the OCA publishes them, gets a development shell of its own: OCB and the repositories its addons depend on come in as flake inputs, and the dev shell installs every addon in it. Our own [Odoo addons](/open-source/#odoo) are built this way.

**Configuration that can't drift.**`addons_path` is derived from the folders actually present, and `odoo.conf` is generated from your flake.

**Development shell.** PostgreSQL, Odoo, and Mailpit through devenv, with live reload, editor integration, and a reproducible Python environment through uv2nix.

**One CLI.**`odoo` handles database provisioning, migration, backup, and restore; adding OCA modules and bundles; and passes everything else to `odoo-bin`.

**Repository standards.** One table in `pyproject.toml` picks a profile, and the `odoo-nix` command writes and checks each repository's lint, format, test, editor, Dependabot, and CI files: the OCA's per-series rules, with the tools locked by Nix so the editor, the dev shell, and CI run the same versions. Reusable GitHub workflows run the lint and test gates, check commit messages, and release addon repositories from `develop` to their series branch. Avunu's own profile is public as [odoo-standards-profile](https://github.com/Avunu/odoo-standards-profile).

**Tests that mean it.**`odoo test` can install every addon on a fresh database, refuses to report a pass when browser tours would be skipped, and measures coverage, which only ratchets up.

**Production.** A `services.odoo-nix` NixOS module that keeps secrets out of the Nix store and migrates the schema before every start, with a snapshot and rollback if it fails. OCI container images too.

Shared logging conventions with frappe-nix and wordpress-nix, so one query covers all three.

## Getting started

You need Nix with flakes and direnv. Run the scaffolder, then follow [Getting started](https://docs.avunu.net/odoo-nix/docs/getting-started/) in the documentation:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">nix</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">run</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">github:Avunu/odoo-nix</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># interactive (gum prompts)</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">nix</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">run</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">github:Avunu/odoo-nix</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">--</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">--addons</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># in a repository of addons</span>
```

Highlights

Scaffolder with a catalog of OCA modules and dependency resolutionAddon repositories with their own dev shell, OCA styleOCA's lint rules, tests, and CI kept in sync from one profiledevenv shell with PostgreSQL, Odoo, and MailpitNixOS module with automatic, snapshotted migrations on deploy

Related projects

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

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

Active

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

MIT[GitHub](https://github.com/Avunu/frappe-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? Our Odoo implementation team builds on it, and we host Odoo on this platform as managed infrastructure.

[Explore Odoo implementation](/services/erp/odoo/)[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/)
