Installing Odoo

There are mutliple ways to install Odoo, or not install it at all, depending on the intended use case.

This documents attempts to describe most of the installation options.

Demo
The simplest “installation”, only suitable for getting a quick feel for Odoo or trying something out
SaaS
Trivial to start with and fully managed and migrated by Odoo S.A., can be used to both test Odoo and use it for your business, prevents complex customization (i.e. incompatible with custom modules or the Odoo Apps Store).

Can be used for both testing Odoo and long-term production use.

Packaged installers
Simple to get started, allows more flexibility in hosting and deploying the system and greater control over where data is stored. The maintenance burden is shifted to the user.

Suitable for testing Odoo, developing modules and can be used for long-term production use with additional deployment and maintenance work.

Source Install
Harder to get started than Packaged installers, provides even greater flexibility: packaged installers don’t generally allow multiple running Odoo versions on the same system, and don’t provide easy source access to Odoo itself.

Good for developing modules, can be used as base for production deployment.

The source code can be obtained by downloading a tarball or using git. Using git is strongly advised, as it makes it easier to update, switch between multiple versions (including the current development version) or contribute.

docker image
If you usually use docker for development or deployment, an official docker base image is available, see the image’s help document for more information.

Editions

There are two different Editions of Odoo: the Community and Enterprise versions. Using the Enterprise version is possible on our SaaS and accessing the code is restricted to Enterprise customers and partners. The Community version is freely available to anyone.

If you already use the Community version and wish to upgrade to Enterprise, please refer to From Community to Enterprise (except for Source Install).

If you wish to access the Enterprise installers/source code, you can:

  • Go to the Download page and log in with your customer credentials
  • Download the source on GitHub using git_(available to partners only)

Demo

To simply get a quick idea of Odoo, demo instances are available. They are shared instances which only live for a few hours, and can be used to browse around and try things out with no commitment.

Demo instances require no local installation, just a web browser.

SaaS

Odoo’s SaaS provides private instances and starts out free. It can be used to discover and test Odoo and do non-code customizations without having to install it locally.

Like demo instances, SaaS instances require no local installation, a web browser is sufficient.

Packaged installers

Odoo provides packaged installers for Windows, deb-based distributions (Debian, Ubuntu, …) and RPM-based distributions (Fedora, CentOS, RHEL, …) for both the Community and Enterprise versions.

These packages automatically set up all dependencies (for the Community version), but may be difficult to keep up-to-date.

Official Community packages with all relevant dependency requirements are available on our nightly server. Both Communtiy and Enterprise packages can be downloaded from our Download page (you must to be logged in as a paying customer or partner to download the Enterprise packages).

Windows

  • Download the installer from our nightly server (Community only) or the Windows installer from the Download page (any edition)
  • Run the downloaded file
  • Accept the UAC prompt
  • Go through the various installation steps

Odoo will automatically be started at the end of the installation.

Configuration

The configuration file can be found at %PROGRAMFILES%\Odoo 10.0-id\server\odoo.conf.

The configuration file can be edited to connect to a remote Postgresql, edit file locations or set a dbfilter.

To reload the configuration file, restart the Odoo service via Services ‣ odoo server.

Deb

Community

To install Odoo 10.0 Community on Debian-based distribution, execute the following commands as root:

# wget -O - https://nightly.odoo.com/odoo.key | apt-key add -
# echo "deb http://nightly.odoo.com/10.0/nightly/deb/ ./" >> /etc/apt/sources.list.d/odoo.list
# apt-get update && apt-get install odoo

You can then use the usual apt-get upgrade command to keep your installation up-to-date.

Enterprise

For Odoo 10.0 Enterprise, get the package from the Download page. You can then use gdebi:

# apt-get install postgresql -y
# gdebi <path_to_installation_package>

Or dpkg (handles less dependencies automatically):

# apt-get install postgresql -y
# 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>

This will install Odoo as a service, create the necessary PostgreSQL user and automatically start the server.

Configuration

The configuration file can be found at /etc/odoo/odoo.conf

When the configuration file is edited, Odoo must be restarted using service:

$ sudo service odoo restart
Restarting odoo: ok

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.