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 on-premise customer or partner to download the Enterprise packages. :::

(install-packages-linux)=

Linux

Prepare

Odoo needs a PostgreSQL server to run properly.

.. tabs::

   .. group-tab:: Debian/Ubuntu

      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:

      .. code-block:: console

         $ sudo apt install postgresql -y

   .. group-tab:: Fedora

      Make sure that the `sudo` command is available and well configured and, only then, execute the
      following command to install the PostgreSQL server:

      .. code-block:: console

         $ sudo dnf install -y postgresql-server
         $ sudo postgresql-setup --initdb --unit postgresql
         $ sudo systemctl enable postgresql
         $ sudo systemctl start postgresql

:::{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:

.. tabs::

   .. group-tab:: Debian/Ubuntu

      .. code-block:: console

         $ 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/{CURRENT_MAJOR_BRANCH}/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.

   .. group-tab:: Fedora

      .. code-block:: console

         $ sudo dnf config-manager --add-repo=https://nightly.odoo.com/{CURRENT_MAJOR_BRANCH}/nightly/rpm/odoo.repo
         $ sudo dnf install -y odoo
         $ sudo systemctl enable odoo
         $ sudo systemctl start odoo

:::{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.

.. tabs::

   .. group-tab:: Debian/Ubuntu

      .. note::
         Odoo {CURRENT_MAJOR_VERSION} 'deb' package currently supports `Debian Buster
         <https://www.debian.org/releases/buster/>`_ and `Ubuntu 18.04
         <https://releases.ubuntu.com/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:

      .. code-block:: console

         # 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:

           .. code-block:: console

              $ 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:

           .. code-block:: console

              $ sudo pip3 install num2words

   .. group-tab:: Fedora

      .. note::
         Odoo {CURRENT_MAJOR_VERSION} 'rpm' package supports Fedora 38.

      Once downloaded, the package can be installed using the 'dnf' package manager:

      .. code-block:: console

         $ sudo dnf localinstall odoo_{CURRENT_MAJOR_BRANCH}.latest.noarch.rpm
         $ sudo systemctl enable odoo
         $ sudo systemctl start odoo

(install-packages-windows)=

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. :::

Download the installer from the nightly server (Community only) or the Windows installer from the Odoo download page (any edition.
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. :::
Accept the UAC prompt.
Go through the installation steps.

Odoo launches automatically at the end of the installation.

5.7 KiB Raw Permalink Blame History