Odoo 19 is the latest version of the powerful open-source Business Management Software that enables companies to streamline operations through an integrated suite of applications. Although Odoo is typically deployed on Linux servers, many developers prefer working within a Windows environment. Fortunately, setting up Odoo 19 on Windows is straightforward, and with tools like PyCharm, developers can efficiently create and manage Odoo projects for both enterprise and community editions.
This guide walks you through the step-by-step process of setting up an Odoo 19 development environment using PyCharm on Windows — from installing Python and PostgreSQL to configuring your IDE and running Odoo locally.
Why Run Odoo 19 on Windows?
While Linux offers better stability and performance for production servers, Windows remains a preferred operating system for many developers due to its familiarity and convenience. Setting up Odoo 19 on Windows allows users to access all the features and modules without needing to configure a Linux server. This flexibility helps developers, small businesses, and learners easily explore Odoo’s ecosystem, especially when developing or testing modules locally.
Step-by-Step Installation Guide for Odoo 19
Let’s go through each step in detail to get your Odoo 19 development environment ready on Windows.
Step 1: Install Python
Odoo 19 requires Python 3.12 or later. To check if Python is installed on your system, open Command Prompt and type:
If it returns a version number, ensure it meets the minimum requirement. If not, download the latest Python installer from the official Python website.
During installation, select “Custom Installation” and check the box labeled “Add Python 3.12 to PATH.” On the optional features screen, select all available checkboxes, then proceed. In the advanced options, enable the first five checkboxes to ensure all developer tools are installed. Once done, click “Install” to complete the process.
Step 2: Install PostgreSQL
PostgreSQL is the database management system used by Odoo. Visit the official PostgreSQL website and download version 16 or newer for Windows (x86-64). Run the installer and ensure all components are selected during installation. When prompted, create a superuser password — you’ll need this later while configuring Odoo.
After installation, the Stack Builder wizard will appear, allowing you to add extra database drivers and tools. Follow the wizard to complete setup. PostgreSQL and pgAdmin 4 (the graphical database manager) will now be available on your system.
Step 3: Configure pgAdmin 4 and PSQL
Launch pgAdmin 4 from the Start menu. You’ll be prompted to set a master password to secure saved connections. Once inside, expand the “Servers” section and locate your PostgreSQL instance. Under “Login/Group Roles,” right-click and choose Create → Login/Group Role. Name the role (for example, “odoo19”) and set a secure password in the Definition tab.
Next, go to the Privileges tab and enable all options. This grants the necessary permissions to your Odoo database user.
Step 4: Install C++ Build Tools
Odoo’s dependencies require C++ build tools for compilation on Windows. Go to the official Visual Studio website and download Build Tools for Visual Studio.
During installation:
Select “Desktop development with C++” as the primary workload.
In Optional Components, ensure all compiler and library tools are checked.
Once installation completes, restart your computer to apply the changes.
Step 5: Download Odoo 19 from GitHub
Visit the official Odoo repository on GitHub and search for “Odoo 19.” Once you locate the repository, click “Code” → “Download ZIP.” Extract the ZIP file to a safe directory, such as:
This folder will contain Odoo’s source code, including the essential odoo-bin file needed to launch the system.
Step 6: Install PyCharm IDE
Download and install PyCharm Community Edition from the JetBrains website. Ensure your system meets the minimum requirements:
RAM: 4 GB (8 GB recommended)
CPU: Modern multi-core processor
Disk Space: 3.5 GB
Resolution: 1024 × 768
Follow the on-screen instructions to complete installation. PyCharm provides an efficient development environment with intelligent coding assistance, debugging tools, and version control integration.
Step 7: Configure Odoo 19 in PyCharm
Open the Project
Launch PyCharm and open the extracted Odoo 19 folder.Create a Configuration File
Inside the project root, create a new file named odoo.conf and paste the following configuration:Update the
db_useranddb_passwordfields with the credentials you created in pgAdmin.Set Python Interpreter
Go to File → Settings → Project → Python Interpreter, click Add Interpreter, and choose System Interpreter. Select the Python 3.12 executable installed earlier.Create a Run Configuration
Navigate to Run → Edit Configurations → + → Python.Name: Odoo 19
Script Path: Browse to the
odoo-binfile in your project directoryParameters:
-c odoo.confWorking Directory: Root folder of your Odoo 19 project
Click Apply and OK.
Install Dependencies
Open PyCharm’s terminal and run:This installs all necessary Python packages for Odoo 19.
Running Odoo 19 on Windows
Once dependencies are installed, click the Run button in PyCharm. The terminal will display log messages indicating Odoo is starting. When the server initializes successfully, open your web browser and go to:
You’ll see the Odoo Database Creation screen. Fill in the following fields:
Master Password:
admin(or your custom value)Database Name:
my_test_dbEmail: [email protected]
Password: Set your admin password
Language/Country: Optional
Demo Data: Optional
Click “Create Database.” Odoo will initialize the database and redirect you to the main dashboard, where you can start exploring its modules.
Exploring the Power of Odoo 19
Once your environment is ready, you can install any of Odoo’s applications — including Sales, Inventory, Accounting, CRM, HR, and Manufacturing. These modules integrate seamlessly, making Odoo one of the most comprehensive Business Management Software solutions for enterprises and developers alike.
For developers, PyCharm’s integrated debugging and version control support make module customization easier than ever. You can create custom apps, extend existing features, or connect third-party APIs — all within a structured development environment.
Conclusion
Setting up Odoo 19 in PyCharm on Windows gives developers and businesses an easy way to explore and customize one of the world’s most popular open-source ERP systems. From Python configuration to PostgreSQL setup, this guide covers every essential step.
Whether you’re a new developer learning Odoo or a company integrating a full-fledged Business Management Software solution, this environment offers flexibility, control, and efficiency — the perfect foundation for modern ERP development.