• Why
• Features
• Supported Matrix
• Quick Start
• What It Does
• Folder Structure
• Non-Interactive Mode
• Running Odoo
• Troubleshooting
• Contributing
• License

Setting up Odoo on a fresh Ubuntu box is a 30-step process. Running multiple versions side-by-side multiplies that by N. This script collapses it into one prompt:

Select option(s) (e.g. 1 or 1,3,5 or 7):

Pick versions, accept defaults, walk away.

• 🎯 Multi-version: install Odoo 14, 15, 16, 17, 18, 19 — or all at once
• 🐍 Isolated Python per version via pyenv
• 🗄️ PostgreSQL configured with passwordless superuser tied to your OS user
• 📦 All system deps: build tools, libxml, libsasl, libldap, libjpeg, libopenblas, Node/npm/less, and more
• 🔁 Idempotent: re-runs skip already-installed components
• 🚦 Soft-fail: one broken package doesn't kill the whole run
• 🤖 Non-interactive mode via env vars for CI / Docker / Vagrant
• 📁 Clean folder layout: workspace/odoo-19/ with .python-version set, no nested venv chaos

Python defaults are overridable at the prompt or via env vars.

git clone https://github.com/<your-username>/odoo-quickstart.git
cd odoo-quickstart
chmod +x odoo_setup.sh
./odoo_setup.sh

wget https://raw.githubusercontent.com/<your-username>/odoo-quickstart/main/odoo_setup.sh
chmod +x odoo_setup.sh
ODOO_VERSIONS="18,19" ./odoo_setup.sh

./odoo_setup.sh --help

The script walks through these stages in order:

1. Prompts for Odoo version(s) and Python version per Odoo version
2. Updates the system (apt-get update && upgrade)
3. Installs system dependencies:
   • Python build deps (python3-dev, libxml2-dev, libxslt1-dev, libssl-dev, libffi-dev, …)
   • Numeric stack (libblas-dev, libopenblas-dev, gfortran)
   • LDAP/SASL/JPEG/PostgreSQL client libs
   • Node.js, npm, less, less-plugin-clean-css
   • pyenv build deps (libbz2-dev, libreadline-dev, libsqlite3-dev, …)
4. Installs PostgreSQL and creates a passwordless superuser matching whoami
5. Installs pyenv and wires it into ~/.bashrc
6. For each selected Odoo version:
   • Installs the chosen Python version via pyenv install
   • Creates workspace/odoo-<v>/
   • Clones odoo/odoo at branch <v>.0 (shallow) into that folder
   • Sets pyenv local <python-version> for the folder
   • Installs requirements.txt against that Python

After running with versions 18 and 19 selected:

~/workspace/
├── odoo-18/
│   ├── .python-version       ← 3.11.9 (pyenv local)
│   ├── odoo-bin
│   ├── requirements.txt
│   ├── addons/
│   ├── odoo/
│   └── ...
└── odoo-19/
    ├── .python-version       ← 3.12.3 (pyenv local)
    ├── odoo-bin
    ├── requirements.txt
    ├── addons/
    ├── odoo/
    └── ...

No virtualenvs. Each Odoo folder is pinned to a specific Python interpreter via pyenv. Packages install into ~/.pyenv/versions/<X.Y.Z>/lib/python*/site-packages/.

Skip all prompts using environment variables — useful for Dockerfiles, CI pipelines, or scripted provisioning.

# Install Odoo 18 and 19 with default Python versions
ODOO_VERSIONS="18,19" ./odoo_setup.sh

# Install all versions
ODOO_VERSIONS="all" ./odoo_setup.sh

# Custom Python per version
ODOO_VERSIONS="17,18" PY_17=3.11.9 PY_18=3.12.3 ./odoo_setup.sh

# Custom workspace location
ODOO_WORKSPACE="/srv/odoo" ODOO_VERSIONS="19" ./odoo_setup.sh

After install completes, reload your shell:

source ~/.bashrc

Then start any installed version:

cd ~/workspace/odoo-19
python odoo-bin -d mydb

Odoo serves on http://localhost:8069. Master password is set on first DB creation.

Just cd into a different folder. pyenv auto-switches Python based on .python-version:

cd ~/workspace/odoo-18 && python --version  # Python 3.11.9
cd ~/workspace/odoo-19 && python --version  # Python 3.12.3

cd ~/workspace/odoo-<v> && pip install -r requirements.txt

source ~/.bashrc

sudo systemctl status postgresql
sudo systemctl start postgresql
sudo systemctl enable postgresql

sudo -u postgres createuser -s "$(whoami)"

sudo apt-get install -y make libbz2-dev libreadline-dev libsqlite3-dev \
    libncursesw5-dev xz-utils tk-dev libxmlsec1-dev liblzma-dev

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb
sudo dpkg -i wkhtmltox_0.12.6.1-3.jammy_amd64.deb
sudo apt-get install -f

python odoo-bin -d mydb --http-port=8070

PRs welcome. See CONTRIBUTING.md for details.

Quick guide:

1. Fork
2. Branch: git checkout -b feat/your-feature
3. Test on a clean Ubuntu VM (Multipass, Vagrant, Docker)
4. Commit: git commit -m 'feat: add support for X'
5. PR

MIT © 2026