odoo-nix

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 or 19.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.

• 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.

• 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 the README:

nix run github:Avunu/odoo-nix                    # interactive (gum prompts)