Zum Hauptinhalt springen

Installation

Prerequisites​

  • Docker (Docker Desktop on Mac, Docker Engine on Linux)
  • git
  • Python 3.10–3.12 (Python 3.13 not yet supported)
  • pipx (for isolated CLI tool installation)

On macOS:

brew install git pipx rsync
brew install --cask docker

On Ubuntu/Debian:

sudo apt-get install git pipx rsync docker.io

Install zodoo​

One-liner installer (installs zodoo CLI + clones zodoo images to ~/.odoo/images):

bash <(curl -fsSL https://raw.githubusercontent.com/Odoo-Ninjas/zodoo/refs/heads/main/install.sh)

This installs the odoo command via pipx and sets up ~/.odoo/images/.

Optional: Passwordless sudo for dev machines​

Required for btrfs/zfs snapshots and some file operations:

cat << 'EOF' > /etc/sudoers.d/odoo
Cmnd_Alias ODOO_COMMANDS_ODOO = /usr/bin/find *, /var/lib/zodoo_env/bin/odoo *, /usr/bin/btrfs subvolume *, /usr/bin/mkdir *, /usr/bin/mv *, /usr/bin/rsync *, /usr/bin/rm *, /usr/bin/du *, /usr/local/bin/odoo *, /usr/bin/btrfs subvol show *, /usr/sbin/gosu *
odoo ALL=NOPASSWD:SETENV: ODOO_COMMANDS_ODOO
EOF

Verify installation​

odoo --version
odoo --help

Shell tab completion​

odoo completion -x >> ~/.bashrc   # bash
odoo completion -x >> ~/.zshrc    # zsh
source ~/.bashrc

Upgrade zodoo​

odoo upgrade

This pulls the latest ~/.odoo/images from git and reinstalls the zodoo package.

Cleanup / Reinstall​

If you had a previous installation (e.g. old "wodoo"):

rm -Rf ~/.odoo/images
bash <(curl -fsSL https://raw.githubusercontent.com/Odoo-Ninjas/zodoo/refs/heads/main/install.sh)