🚀 odoo-quickstart

One script. Multiple Odoo versions. Zero configuration headaches.

A no-nonsense Ubuntu installer that gets Odoo 14 through 19 running side-by-side in isolated Python environments — system deps, pyenv, PostgreSQL, Node/less, and Odoo source, all configured in a single run.

---

📋 Table of Contents

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

---

🤔 Why

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.

---

✨ Features

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

---

🎯 Supported Matrix

Odoo Version	Default Python	Status	Branch
14	3.8.18	✅ Supported	14.0
15	3.8.18	✅ Supported	15.0
16	3.10.13	✅ Supported	16.0
17	3.10.13	✅ Supported	17.0
18	3.11.9	✅ Supported	18.0
19	3.12.3	✅ Supported	19.0

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

Ubuntu	Status
20.04 LTS	✅ Tested
22.04 LTS	✅ Tested
24.04 LTS	✅ Tested

---

⚡ Quick Start

Interactive (recommended for first-time setup)

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

One-liner (when you know what you want)

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

View options

./odoo_setup.sh --help

---

🔧 What It Does

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

---

📁 Folder Structure

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

---

🤖 Non-Interactive Mode

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

Variable	Purpose	Example
ODOO_VERSIONS	Comma list or "all"	"16,18,19"
ODOO_WORKSPACE	Where to clone Odoo (default: ~/workspace)	/srv/odoo
PY_<N>	Override Python for Odoo N	PY_18=3.11.9

---

▶️ Running Odoo

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.

Switching versions

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

---

🔥 Troubleshooting

Some pip packages fail to compile

Usually means a missing system library. Check the error for the missing *.h header, then sudo apt-get install <lib>-dev. Re-run:

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

pyenv: command not found after install

Your shell hasn't picked up the new ~/.bashrc entries. Either:

source ~/.bashrc

…or open a new terminal.

PostgreSQL connection refused

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

If the role doesn't exist:

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

Python version install fails with build errors

A pyenv build dep is missing. Re-run the script — step 3 covers them — or manually:

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

Odoo 14/15 wkhtmltopdf issues

Older Odoo versions need wkhtmltopdf 0.12.5 (not the version in Ubuntu repos):

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

Port 8069 already in use

Another Odoo instance is running. Either kill it or specify a different port:

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

---

🤝 Contributing

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

---

📜 License

MIT © 2026

---

If this saved you an afternoon, give it a ⭐