How to Set Up Odoo 19 in PyCharm on Windows
Odoo is a powerful open-source ERP (Enterprise Resource Planning) platform that helps businesses manage everything from sales and inventory to accounting and HR—all in one place. With its modular structure, users can easily customize and extend Odoo to fit their business needs.
In this guide, we’ll walk you through how to set up Odoo 19 on Windows using PyCharm, one of the most popular IDEs for Python development. By the end of this tutorial, you’ll have a fully configured Odoo development environment ready for customization and module development.
Why Set Up Odoo on Windows?
While Odoo is commonly deployed on Linux servers for production, many developers prefer using Windows for local development because it’s simple, familiar, and doesn’t require switching to another operating system. Setting up Odoo 19 on Windows allows you to easily test, customise, and build modules using tools like PyCharm, PostgreSQL, and Git, all within a user-friendly environment.
It’s especially convenient for beginners or developers who already use Windows for other projects. With PyCharm’s powerful debugging and coding features, developing and maintaining Odoo modules on Windows becomes smooth and efficient—no need for complex command-line setups or virtual machines.
Step-by-Step Installation Guide for Odoo 19
Step 1: Python Installation
Before starting the installation, make sure Python isn't already installed on your computer. In the Command Prompt, type python --version.
- If Python is not installed, you will see an error message like "'python' is not recognized as an operable program, batch file, or internal or external command."
- If Python is installed, a version number like "Python 3.xx.x" will be displayed.
You must have Python 3.12 or later in order to use Odoo 19. If Python is not installed on your computer or if the version is less than 3.12, download the installer from the Python Downloads page.
After downloading the installer, open the folder that contains it. The downloaded .exe file will appear after the folder has been opened. Make sure to tick the "Add Python.exe to PATH" box when you choose the "Custom Installation" option during installation.
After checking all the boxes on the Optional Features screen, click "Next".
Check the boxes for the first five settings in the advanced settings area, then click "Install" to continue.
Step 2: Install PostgreSQL
Visit the official PostgreSQL website, download the installer, and then follow the installation guidelines to get PostgreSQL installed on your computer.
Installation of PostgreSQL version 16 or later is advised. To start the download, click the icon located under the "Windows x86-64" section. Launch the installer after it has finished downloading. Make sure you check every checkbox on the "Select Components" page. Choose a password for the superuser account on the "Password" screen. Proceed with the installation, leaving all other settings at their default settings.
Clicking the Next button will bring up the window below.
Click the Next button, and you will see the window below.
The window below will appear when you click the Next button.
Once this option is enabled, you may set the password by clicking the Next button.
Move on with the default port number.
Choose Next button with Advanced option
Click on the Next button for the pre-summary installation.
Choose Next button for Installation.
Once the installation done choose Finish button.
Select PostgreSQL17(x64) on port 5432, and move on with Next button.
After PostgreSQL has finished installing, the Stack Builder process will start up immediately. You can install extra PostgreSQL components and extensions with this program. Choose every program that is listed under the "Database Drivers" category in the wizard. Once the components have been chosen, complete the wizard and the installation procedure by following the instructions.
Choose Next button to continue.
Continue with Next button to download all the package. Once all packages are downloaded choose Finish button
Step 3: Configuring pgAdmin 4 and PSQL
Since pgAdmin 4 was chosen on the "Select Components" screen during the PostgreSQL installation, it is already installed on your machine. Run pgAdmin 4 to start the configuration process. Expand the "Servers" section in the Object Explorer on the left. To protect pgAdmin, you will be asked to input a master password, which is used to store and encrypt your saved connection information.
Next, find and expand the PostgreSQL instance (sometimes referred to as "PostgreSQL" or "Postgres") within the extended "Servers" tree. The "Login/Group Roles" section is located within this. In order to define a new role, right-click on "Login/Group Roles" and select "Create" > "Login/Group Role". Depending on your requirements, you can create role parameters, assign a name, and grant privileges.
Open the "Create – Login/Group Role" box and select the "Definition" option. The password for the new role can be created here. Using this role will need you to login to the PostgreSQL server, so be careful to pick a strong and memorable password.
Turn on every option found under the "Privileges" menu and save it.
Step 4: Installing the C++ Build Tools via Visual Studio
A fundamental programming language required for creating Windows programs is C++. A comprehensive collection of compilers, libraries, and development tools required to construct desktop apps, background services, and other C++ components are offered by Visual Studio Build Tools. Download the installer for the C++ Build Tools from the official Visual Studio website to get started:
The "Desktop development with C++" workload should be chosen throughout the installation procedure. Additionally, make sure you verify the components in the optional components. section match the reference image or figure that was supplied. For a full C++ programming environment, these elements are necessary.
After choosing every necessary component, continue the installation. Restart your computer when the installation is complete to make sure all the settings and modifications are applied correctly.
Step 5: Downloading Odoo 19 from GitHub
Getting Odoo 19 from GitHub is a straightforward process. Start by visiting the official GitHub. In the search bar at the top of the page, type “Odoo” and press Enter. From the search results, click on the first repository listed—this is typically the official Odoo repository, as shown in the reference image below.
After clicking the link, make sure the branch displayed is 19. When you click the "Code" button, the Odoo 19 "Download ZIP" option will appear. After extracting it, store it somewhere secure, ideally in the home directory.
Step 6: PyCharm Installation
Minimum System Requirements
Component | Requirement |
CPU | Intel Core i3 or equivalent |
RAM | 4GB, 8GB (recommended) |
Disk Space | ~2.5 GB for installation + additional space for projects and caches |
Display | 1024×768 minimum resolution |
The PyCharm Community Edition is available for download from the official JetBrains website if your system satisfies the previously stated requirements:
During the PyCharm installation, choose the installation options shown in the figure.
Finish the installation process.
Step 7: Setting Up Odoo 19 Development Environment in PyCharm
Setting up the development environment is the last step in configuring Odoo 19. Launch PyCharm from your apps and choose "Open an existing project" to complete this.
Right-click on the Odoo-19 folder from the project panel (left side) to create an odoo.conf file inside the directory.
In it, paste these codes.
[options]
; Is This The Password That Allows Database Operations:
admin_passwd = admin
db_host = localhost
db_port = 5432
db_user = odoo19
db_password = admin
addons_path =
http_port = 8019
Using pgAdmin, update the db_user and db_password to the values specified during PostgreSQL setup. Also, change the addons path to correspond to the addons directory inside the odoo-19.0 folder that was extracted.
Next, go to Settings > Project Settings > Python Interpreter and set up the Python interpreter. In the Python Interpreter settings window, select "Add Interpreter."
Click OK to continue after choosing "System Interpreter" as the interpreter type (as seen in the figure).
Finally, in order to start the Odoo 19 instance, we have to create a run configuration. To do this, choose "Edit Configurations" from the "Current File" menu.
Choose Python from the list of available configuration types after clicking the addition (+) symbol in the upper-left corner of the Run/Debug Configurations box.
As shown in the example, enter the necessary information in the configuration window:
Name: Provide the structure a fitting name.
Script Path: From the extracted Odoo-19 project directory, locate and choose the odoo-bin file.
Python Interpreter: If the interpreter isn't already chosen, set it.
Directory of Work: Select the extracted Odoo-19 project's root folder.
Specifications: -c odoo.conf
Click Apply and then OK once everything is configured.
To install the necessary packages, launch PyCharm's Terminal and type the following command. To see the install requirements, run the command below.
pip install -r requirements.txt
Verify that the requirements.txt file is in the root directory of the extracted Odoo-19 project.
Now all you need to do is click PyCharm's green Run button to launch Odoo using your odoo.conf configuration file.
Once you click Run, Odoo should be available in your browser at http://localhost:8019, and the logs should appear in PyCharm's Run box.
The "Created Database" screen will appear.
You will be asked to complete the following:
Master Password: Configure the master password (from admin_passwd in your odoo.conf).
Select any name for the database, such as my_test_db.
Email: The admin user will log in using this email. For instance, [email protected].
Password: Configure the administrator's password.
Enter the password again to confirm it.
(Optional) Language Choose the language that you like.
Country: (Optional) Choose your nation.
Sample information: (Optional) If you want a clean database, uncheck this.
Click "Create database" once all the fields have been filled up.
After initializing, Odoo will take you to the main dashboard.
Install your preferred apps to get the most out of Odoo.