Packaged installers

Odoo provides packaged installers for Debian-based Linux distributions (Debian, Ubuntu, etc.), RPM-based Linux distributions (Fedora, CentOS, RHEL, etc.), and Windows for the Community and Enterprise editions.

Official Community nightly packages with all relevant dependency requirements are available on the nightly server.

Note

Nightly packages may be difficult to keep up to date.

Official Community and Enterprise packages can be downloaded from the Odoo download page.

Note

It is required to be logged in as a paying customer or partner to download the Enterprise packages.

Linux

Prepare

Odoo needs a PostgreSQL server to run properly.

The default configuration for the Odoo ‘deb’ package is to use the PostgreSQL server on the same host as the Odoo instance. Execute the following command to install the PostgreSQL server:

$ sudo apt install postgresql -y

Warning

wkhtmltopdf is not installed through pip and must be installed manually in version 0.12.6 for it to support headers and footers. Check out the wkhtmltopdf wiki for more details on the various versions.

Repository

Odoo S.A. provides a repository that can be used to install the Community edition by executing the following commands:

$ wget -q -O - https://nightly.odoo.com/odoo.key | sudo gpg --dearmor -o /usr/share/keyrings/odoo-archive-keyring.gpg
$ echo 'deb [signed-by=/usr/share/keyrings/odoo-archive-keyring.gpg] https://nightly.odoo.com/17.0/nightly/deb/ ./' | sudo tee /etc/apt/sources.list.d/odoo.list
$ sudo apt-get update && sudo apt-get install odoo

Use the usual apt-get upgrade command to keep the installation up-to-date.

Note

Currently, there is no nightly repository for the Enterprise edition.

Distribution package

Instead of using the repository, packages for both the Community and Enterprise editions can be downloaded from the Odoo download page.

Note

Odoo 17 ‘deb’ package currently supports Debian Buster and Ubuntu 18.04 or above.

Once downloaded, execute the following commands as root to install Odoo as a service, create the necessary PostgreSQL user, and automatically start the server:

# dpkg -i <path_to_installation_package> # this probably fails with missing dependencies
# apt-get install -f # should install the missing dependencies
# dpkg -i <path_to_installation_package>

Warning

  • The python3-xlwt Debian package, needed to export into the XLS format, does not exist in Debian Buster nor Ubuntu 18.04. If needed, install it manually with the following:

    $ sudo pip3 install xlwt
    
  • The num2words Python package - needed to render textual amounts - does not exist in Debian Buster nor Ubuntu 18.04, which could cause problems with the l10n_mx_edi module. If needed, install it manually with the following:

    $ sudo pip3 install num2words
    

Windows

Warning

Windows packaging is offered for the convenience of testing or running single-user local instances but production deployment is discouraged due to a number of limitations and risks associated with deploying Odoo on a Windows platform.

  1. Download the installer from the nightly server (Community only) or the Windows installer from the Odoo download page (any edition.

  2. Execute the downloaded file.

    Warning

    On Windows 8 and later, a warning titled Windows protected your PC may be displayed. Click More Info and then Run anyway to proceed.

  3. Accept the UAC prompt.

  4. Go through the installation steps.

Odoo launches automatically at the end of the installation.