DEV Community

Cover image for How to Set Up an Odoo Development Environment (Step-by-Step)
Mohit YLYT
Mohit YLYT

Posted on

How to Set Up an Odoo Development Environment (Step-by-Step)

#odoo #techtalks #python #sql

Odoo has become one of the most widely adopted open-source ERP platforms globally, and demand for skilled Odoo developers continues to rise in 2025. Whether you're building custom modules or extending existing functionality, having a properly configured local development environment is the foundation of productive Odoo ERP Development.

This guide walks you through the complete setup — from Python installation to launching your first local instance.

What You'll Need Before Starting

  • A machine running Windows, Ubuntu, or macOS
  • Basic familiarity with the command line
  • Git installed on your system
  • An IDE (PyCharm or VS Code recommended)

Step 1: Install Python & System Dependencies

Odoo 18 and 19 require Python 3.12+. Using an older version will cause dependency errors.

Windows:

Ubuntu/Linux:

sudo apt update && sudo apt upgrade -y
sudo apt install python3-dev python3-pip python3-venv git build-essential libxslt-dev libzip-dev libldap2-dev libsasl2-dev -y
Enter fullscreen mode Exit fullscreen mode

Step 2: Set Up PostgreSQL

Odoo uses PostgreSQL exclusively for backend data storage. Version 16 or 17 is recommended.

sudo -u postgres createuser --superuser --pwprompt $USER
Enter fullscreen mode Exit fullscreen mode

This user will be referenced in your Odoo config file later.

Step 3: Clone the Odoo Source Code

Rather than using packaged executables, clone directly from GitHub. This gives you full access to source files for debugging and customization.

cd ~/development
git clone https://github.com/odoo/odoo.git --depth 1 --branch 18.0
Enter fullscreen mode Exit fullscreen mode

Replace 18.0 with your target version (17.0, 19.0, etc.).

Step 4: Configure a Python Virtual Environment

Isolating dependencies per project prevents version conflicts — especially important if you work across multiple Odoo versions.

cd odoo
python3 -m venv venv
source venv/bin/activate        # Linux/macOS
# venv\Scripts\activate         # Windows

pip install --upgrade pip
pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode

Step 5: Create the Odoo Configuration File

Create a file named odoo.conf in your workspace root:

[options]
db_host = localhost
db_port = 5432
db_user = your_pg_username
db_password = your_pg_password
addons_path = addons,custom_addons
logfile = /var/log/odoo/odoo.log
Enter fullscreen mode Exit fullscreen mode

This file tells Odoo how to connect to your database and where to look for modules.

Step 6: Set Up Your IDE

PyCharm (Community Edition):

  • Open the Odoo root folder as a project
  • Go to Settings → Project → Python Interpreter → select the interpreter inside your venvfolder.
  • Go to Run → Edit Configurations → create a new Python script, set the path to odoo-bin, and add -c odoo.conf as parameters

Visual Studio Code:

  • Open the workspace folder
  • Use Ctrl+Shift+P → Python: Select Interpreter → map to your venv
  • Install extensions: Python (Microsoft) and XML (Red Hat)

Both IDEs support breakpoints, variable inspection, and an integrated terminal—pick whichever fits your workflow.

Step 7: Launch and Initialize

From your activated virtual environment, run:

python odoo-bin -c odoo.conf
Enter fullscreen mode Exit fullscreen mode

Open your browser and navigate to http://localhost:8069. You'll see the database creation screen — fill in your database name, master password, and admin credentials to launch your local instance.

Final Thoughts

A clean local setup saves hours of debugging down the line. Once your environment is running, the next step is scaffolding your first custom module — where the real Odoo development begins. For businesses looking to implement or extend Odoo at scale, working with an experienced Odoo ERP Development partner can significantly reduce time-to-deployment.

FAQs

Which Python version does Odoo 18/19 require?
Both require Python 3.12 or higher. Using an earlier version will break dependency installation.

Can I run multiple Odoo versions on the same machine?
Yes — use separate virtual environments and separate PostgreSQL databases for each version to avoid conflicts.

Do I need a paid IDE license to develop Odoo?
No. PyCharm Community Edition and VS Code are both free and fully capable for Odoo development.

What's the difference between cloning Odoo vs. installing it as a package?
Cloning gives you direct access to source code, making it far easier to debug, trace errors, and build custom modules alongside the core.

Top comments (0)