How to Download and Install Odoo Community on Windows and Linux in 2026

Are you planning to try Odoo for your business? Then the best way to begin is by installing the Odoo Community Edition locally on your system. In this guide, we’ll walk you through how to install Odoo Community on both Windows and Linux (Ubuntu), even if you are not from a technical background. Let’s make this simple and easy for you.

First, What is Odoo Community?

Odoo Community Edition is the open-source version of Odoo ERP. It’s free to use and comes with many core modules like CRM, Sales, Inventory, Accounting, and more. If you want to test or use Odoo locally, this is the best starting point.

How to Prepare Your Environment for Odoo 2026

Before your Odoo Community Edition download even begins, getting your environment right is the single step most failed installations skip. Mismatched dependencies don't just slow things down — they break the setup entirely, often in ways that are frustrating to diagnose.

2026 Release Cycle: Odoo's current active branches are 19.0 and the emerging 20.0. Choosing the right branch upfront matters, especially if you plan to upgrade versions later — module compatibility shifts significantly between major releases.

Runtime Requirement: Python 3.10 or higher is mandatory. Earlier versions lack the performance improvements and library support that Odoo's core framework depends on in 2026. Install Python before anything else and confirm the version in your terminal.

Database Layer: PostgreSQL 15 or 16 is the required database engine. Older PostgreSQL versions introduce stability risks under concurrent load, particularly when running financial or inventory modules.

Hardware baseline is where many first-time deployments underestimate their needs:

Hardware warning: According to Odoo Nightly Builds Documentation, 4GB RAM is the practical floor for production — particularly if you're running manufacturing or multi-company modules.

With your environment checklist confirmed, the next step is locating and downloading the correct installer file.

Download the Odoo Community Edition Installer

Finding the right source is non-negotiable before you install Odoo Community Edition. Unofficial mirrors carry outdated or tampered builds — always start at the official nightly.odoo.com repository, where Odoo publishes verified builds for every major version branch.

Follow these steps to get the correct file:

• Choose your version branch. The nightly builds site organizes downloads by version (e.g., 18.0 or 19.0). Select the branch that matches your production requirements — mixing versions between your server dependencies and the installer is a common cause of broken setups.

• Pick the right package for your OS. Windows users need the .exe all-in-one installer, which bundles Python and PostgreSQL. Linux users should grab the .deb or .rpm source package depending on their distribution.

• Verify file integrity before proceeding. Each build on the nightly site includes an accompanying checksum file. On Windows, run CertUtil -hashfile odoo_setup.exe SHA256 in Command Prompt and compare the output against the posted hash. On Linux, use sha256sum. This single step rules out corrupted downloads and supply-chain tampering.

For a broader look at setup options across environments, local machines and remote servers follow slightly different paths worth reviewing before committing to a configuration.

Once your verified installer is sitting in your downloads folder, you're ready to launch the Windows setup wizard — which is exactly where the next step picks up.

Install Odoo on Windows Using the All-in-One Setup

Knowing how to install Odoo on Windows correctly means avoiding the most common trap: skipping component selection and ending up with a broken database connection. With your verified .exe in hand from Step 1, follow these six steps to complete a clean installation.

1. Right-click the installer and select "Run as administrator" to ensure it has the system permissions needed to create services and write to program directories.

2. Accept the license agreement and proceed to the component selection screen — this is where most users make critical mistakes.

3. Check both "Odoo Community Edition" and "PostgreSQL" in the component list. As noted by the Odiware Technical Blog, the Windows installer bundles a PostgreSQL instance automatically if one isn't already present on your machine.

4. Configure your database credentials when prompted. The default username is openpg — change the password to something secure before proceeding, since this credential controls your entire Odoo database access.

5. Leave the Windows Service option enabled. This setting ensures Odoo launches automatically on startup and runs reliably in the background without manual intervention.

6. Click Install and wait for completion, then verify the service is active by checking Windows Task Manager or Services (services.msc).

In practice, the full process takes under ten minutes on a modern machine. Once the service is confirmed running, your browser should reach the Odoo setup screen at localhost:8069. Linux users, however, face a different process entirely — one where an automated script handles the heavy lifting.

“Tired of doing this manually? Let our experts handle your Odoo configuration.” 

Installing Odoo Community on Linux (Ubuntu)

Step 1: Update Your System

sudo apt update && sudo apt upgrade

Step 2: Install Dependencies

sudo apt install git python3-pip build-essential wget python3-dev python3-venv \
  libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools \
  node-less libjpeg-dev libpq-dev libxml2-dev libssl-dev libffi-dev

Step 3: Install PostgreSQL

sudo apt install postgresql
sudo systemctl start postgresql
sudo systemctl enable postgresql

Create PostgreSQL User:

sudo su – postgres
createuser –createdb –username postgres –no-createrole –no-superuser –pwprompt odoo16
exit

Step 4: Install Wkhtmltopdf

sudo apt install wkhtmltopdf

Step 5: Create Odoo User

sudo adduser --system --home=/opt/odoo --group odoo

Step 6: Download Odoo Source

sudo git clone https://www.github.com/odoo/odoo --depth 1 --branch 16.0 --single-branch /opt/odoo/odoo

Step 7: Install Python Requirements

cd /opt/odoo/odoo
sudo pip3 install -r requirements.txt

Step 8: Configure Odoo

Create config file: sudo nano /etc/odoo.conf and paste this:

[options]
admin_passwd = admin
db_host = False
db_port = False
db_user = odoo16
db_password = your_password
addons_path = /opt/odoo/odoo/addons
logfile = /var/log/odoo/odoo.log

Step 9: Run Odoo

cd /opt/odoo/odoo
./odoo-bin -c /etc/odoo.conf

Open your browser and go to: http://localhost:8069. You’ll now see your Odoo database setup page! 

Install Odoo on Linux Using the Automated Script

For VPS and production servers, the automated script approach is the fastest path to a clean, dependency-complete setup — and any solid Odoo 19 installation guide for Linux will point you toward the same tool.

Connect via SSH to your Ubuntu or Debian server first, then pull the Yenthe666 install script — the recognized community standard for automated Linux Odoo deployments in 2026. This script handles Python dependencies, PostgreSQL configuration, and the Odoo service setup in a single pass.

Run the following commands in sequence:

sudo apt-get update && sudo apt-get upgrade -y
wget https://raw.githubusercontent.com/Yenthe666/InstallScript/18.0/odoo_install.sh

chmod +x odoo_install.sh

sudo ./odoo_install.sh

Here's what each step accomplishes:

1. Update your package index to avoid version conflicts during dependency installation.

2. Download the script directly from the official GitHub repository — never from an unverified mirror.

3. Set execute permissions with chmod +x so the system can run the file.

4. Execute the script to automate the full stack: Python virtual environment, PostgreSQL user creation, and the Odoo systemd service.

For a deeper breakdown of each configuration step, this Linux setup walkthrough covers dependency management in additional detail.

Once the script completes, Odoo runs on port 8069. However, if your environment demands containers, isolated networking, or horizontal scaling, a native install may not be enough — which is exactly where Docker becomes the more practical choice.

Deploy Odoo via Docker for Scalable Environments

Docker offers a compelling alternative to the standard Odoo Linux script install or Windows installer — especially for IT managers who need consistent, reproducible environments across multiple servers. Per the Odoo Documentation 19.0, official Docker images for Odoo 19.0 and 18.0 are actively maintained on Docker Hub, making containerized deployment both reliable and fast. For teams managing version upgrades, understanding what deployment costs look like upfront helps set realistic infrastructure budgets.

Prerequisites: Install Docker Desktop (Windows) or Docker Engine (Linux) along with Docker Compose on the host machine before proceeding.

Create a docker-compose.yml file with the following configuration:

services:

   web:

     image: odoo:18.0

     depends_on:

       - db

     ports:

       - "8069:8069"

     volumes:

       - odoo-web-data:/var/lib/odoo

   db:

     image: postgres:15

     environment:

       - POSTGRES_PASSWORDS_DB=postgres

       - POSTGRES_PASSWORDS_PASSWORD=odoo

       - POSTGRES_PASSWORDS_USER=odoo

     volumes:

       - odoo-db-data:/var/lib/postgresql/data

volumes:

   odoo-web-data:

   odoo-db-data:

Execute the deployment in three steps:

1. Save the file, then open a terminal in the same directory.

2. Run docker-compose up -d to pull the images and initialize both containers in detached mode.

3. Confirm containers are running with docker-compose ps.

Port 8069 maps directly to the host, so the Odoo interface becomes accessible immediately — which brings us to the critical next step: configuring your database and securing access before any real data enters the system.

Configure the Initial Database and Master Password

With your Odoo instance running — whether via the automated Linux script or a Docker container — the next critical step is the first-run database setup through the web interface.

Access the setup screen by opening a browser and navigating to http://localhost:8069. Odoo presents a database creation form before anything else loads.

⚠️ Warning: Set a strong Master Password before anything else. This password is required for all future database backups, duplicates, and deletions — losing it can lock you out of critical administrative functions entirely.

Follow this sequence to complete the setup correctly:

1. Set the Master Password — use a unique, complex string and store it in a password manager immediately.

2. Name your database — use a descriptive, function-based convention such as Construction_Prod or Retail_Staging to avoid confusion across environments.

3. Select your language and country — this pre-configures tax rules, date formats, and localization settings.

4. Create the admin account — choose a strong email and password for the primary administrator.

5. Skip Demo Data — leave this checkbox unchecked for any live production environment. Demo data pollutes your records and is difficult to remove cleanly.

In practice, teams managing multiple Odoo instances benefit from a clear naming convention from day one — especially when planning future version upgrades or migrations between major releases.

Even a clean installation can surface unexpected errors after this step, so the next section covers the most common 2026 configuration issues and exactly how to resolve them.

How to Troubleshoot Common 2026 Installation Errors

Even a clean setup can hit snags. Below are the four most frequent failure points — and how to resolve each one quickly.

• Port 8069 conflict: If Odoo won't start, another process may already be occupying its default port. Run netstat -tulnp | grep 8069 on Linux (or netstat -ano | findstr 8069 on Windows) to identify the blocking process. Either terminate it or update your Odoo config to use an alternate port.

• Broken PDF reports: PDF output with missing headers or footers almost always traces back to an outdated rendering engine. Per the Odoo Community Forum, wkhtmltopdf version 0.12.6 or higher is required for correct PDF header and footer rendering. Download the correct binary for your OS and confirm the path is registered in your Odoo server settings.

• Firewall blocking ERP traffic: On Linux, UFW may silently drop incoming requests. Run sudo ufw allow 8069/tcp followed by sudo ufw reload to open the necessary port.

• Database connection failures: A dropped PostgreSQL service is a common culprit. Check its status with sudo systemctl status postgresql and restart with sudo systemctl restart postgresql if it's inactive.

In practice, resolving these four issues covers the majority of post-install headaches. Once your instance is stable, the natural next question becomes whether the out-of-the-box Community Edition can actually scale to meet your business's growing demands — something worth examining closely before planning any version upgrade.

How to Scale Your Odoo Instance Post-Installation

A successful installation is just the starting line. Out-of-the-box Community Edition covers core accounting, inventory, and CRM well — but businesses with complex HR workflows, construction project tracking, or multi-entity reporting will quickly bump into its limits. Native modules rarely handle industry-specific requirements without customization, and that gap widens as your team grows.

Version migration is another pressure point. Moving from Odoo 17 to 19, for example, isn't a simple upgrade click — it involves database schema changes, custom module compatibility checks, and data integrity validation. A misstep can corrupt production records. Experienced partners who handle version upgrades reduce that risk significantly by following structured migration protocols.

Certified Odoo expertise directly reduces workforce burden. In practice, internal IT teams spending weeks on ERP configuration are pulled away from strategic work. As Odiware puts it, certified expertise "simplifies complex business operations... accelerating growth for SMEs" — a claim that holds up when you consider the alternative: prolonged self-managed rollouts.

End-to-end ERP customization ROI compounds over time. Custom workflows eliminate manual workarounds, reduce data entry errors, and improve reporting accuracy — measurable outcomes that justify the upfront investment.

On the other hand, not every business needs full-service implementation on day one. However, understanding where the Community Edition ceiling sits helps you plan the right moment to scale. With that full picture in mind, the key takeaways ahead will help you decide your next move with confidence.

What You Need to Know: Key Takeaways for 2026

Installing Odoo Community Edition in 2026 is more straightforward than ever — but only when the fundamentals are locked in from the start. According to Odiware Internal Research, successful ERP deployment in 2026 relies on matching software versions with specific hardware overhead. Get that pairing wrong, and no amount of troubleshooting will produce a stable system.

Four essential insights carry the most weight from this guide:

• Python 3.11 and PostgreSQL 15 or 16 are non-negotiable. Running Odoo on mismatched versions creates silent dependency failures that surface unpredictably under production load.

• Windows is the right call for local testing. The .exe installer compresses a multi-step process into minutes, making it the fastest path to spin up a demo or development environment — as demonstrated in this quick Windows setup walkthrough.

• Linux scripted installs win in production. A properly configured Ubuntu or Debian environment with a dedicated system user, systemd service, and Nginx reverse proxy delivers the reliability that real business operations demand.

• Security is a post-install priority, not an afterthought. The Master Password and firewall rules are your first line of defense. Both must be configured before any external traffic reaches your instance.

Whether you're evaluating Odoo for the first time or migrating an existing stack, the steps in this guide give you a repeatable, version-specific foundation. Take the next step by exploring deeper Odoo customization resources to extend what you've built.