How to Install and Setup Odoo on Ubuntu Linux 2

How to Install and Setup Odoo on Ubuntu Linux

This brief guide shows how to install Odoo on Ubuntu Linux. If you are a beginner or a new user and want to install the Odoo on your ubuntu Linux system then this short tutorial is useful and handy for you.

Odoo is simple, popular and open-source suite of business management application. It provides many business management application such as CRM, e-Commerce solutions, website builder, Billing & Accounting, invoices, manufacturing, orders, products, inventory, Point of Sale, Warehouse Management, and much more.

For more details about Odoo, please visit its official homepage.

Install and Setup Odoo on Ubuntu Linux

When you are ready, follow the steps below to install Odoo on Ubuntu Linux.

There are many ways to install it on Ubuntu Linux. The quickest way to install it by using the official Odoo APT repositories. In this tutorial, we are going to install it by custom way.

Step 1 : Install Required Dependencies

First of all, you will need to install required and supporting dependencies to install Odoo in you system. To do that, run the commands below:

sudo apt update
sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libfreetype6-dev libxml2-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less libjpeg-dev zlib1g-dev libpq-dev  libxslt1-dev libldap2-dev libtiff5-dev libjpeg8-dev libopenjp2-7-dev liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev libpq-dev

Step 2 : Create a Odoo system User

Next, you will need to create a system user account for Odoo called odoo with home directory /opt/odoo :

sudo useradd -m -d /opt/odoo -U -r -s /bin/bash odoo

Step 3 : Install and Configure PostgreSQL

Odoo uses PostgreSQL database server as backend to store content. To install PostgreSQL, run the command below:

sudo apt install postgresql

To enable and start PostgreSQL services, run the command below:

sudo systemctl enable --now postgresql.service

Now, create a PostgreSQL database user called odoodbuser . To do that, run the commands below:

sudo su - postgres -c "createuser -s odoodbuser"

Step 4 : Install Wkhtmltopdf

The Wkhtmltopdf provides a set of open-source command-line tools that can render HTML into PDF and other various image formats. To download and install Wkhtmltopdf package, run the wget command as shown below:

cd /tmp
sudo apt install ./wkhtmltox_0.12.5-1.bionic_amd64.deb

Step 5 : Install and Configure Odoo

Before installing Odoo, switch to the Odoo system user account that we created in above steps:

sudo su - odoo

Next, run the command below to clone Odoo version 15 :

git clone --depth 1 --branch 15.0 /opt/odoo/odoo

At the writing of this tutorial, the latest version of Odoo is 15. If there are a new version available then you should clone that version.

After download, change your directory into Odoo’s directory:

cd /opt/odoo

After that, install and configure all required modules for running Odoo by running the command below;

python3 -m venv odoo-venv
source odoo-venv/bin/activate
pip3 install wheel
pip install python-ldap
pip3 install -r odoo/requirements.txt

Next, create a new directory for custom 3rd party addons:

mkdir /opt/odoo/odoo-custom-addons

To exit and back to your sudo user, run the command below:


Next, Create and open Odoo’s configuration file:

sudo nano /etc/odoo.conf

After that, copy the below content and paste into the file:

; This is the password that allows database operations:
admin_passwd = type_new_password_here
db_host = False
db_port = False
db_user = odoodbuser
db_password = False
addons_path = /opt/odoo/odoo/addons,/opt/odoo/odoo-custom-addons

Save and exit.

Step 6 : Create a Systemd Unit File

Now, you will need to create a systemd unit file to control Odoo services. To do that, run the command below;

sudo nano /etc/systemd/system/odoo.service

Copy the below content and paste into the file:

Requires=postgresql.service postgresql.service

ExecStart=/opt/odoo/odoo-venv/bin/python3 /opt/odoo/odoo/odoo-bin -c /etc/odoo.conf


Save your changes and exit.

Next, reload systemd daemon to notify that a new file is created:

sudo systemctl daemon-reload

Start up the Odoo service and enable it to start on boot:

sudo systemctl enable --now odoo

Run the command below to verify the installation and check service status:

sudo systemctl status odoo

The above command will print a output similar like below:

● odoo.service - Odoo
     Loaded: loaded (/etc/systemd/system/odoo.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2021-10-28 14:48:16 CDT; 17s ago
   Main PID: 1858 (python3)
      Tasks: 2 (limit: 2761)
     Memory: 56.2M
     CGroup: /system.slice/odoo.service
             └─1858 /opt/odoo/odoo-venv/bin/python3 /opt/odoo/odoo/odoo-bin -c /etc/odoo.conf

Step 7 : Login to Odoo

To login, open your favorite browser and browse to http://hostname_or_IP_address>:8069 :


If the installation is successful then you get a result similar like below:

odoo login screen

Fill the database account details and admin password that you defined in the configuration file above and complete the setup.

If you face issues and Internal server error or get error when launch Odoo setup wizard then you need to configure PostgreSQL to trust all local connections.

To do that, open PostgreSQL configuration file by running command below:

sudo nano /etc/postgresql/12/main/pg_hba.conf

Replace the version number with yours.

After open the configuration file, replace MD5 or Peer with trust as shown the below:

# "local" is for Unix domain socket connections only
local   all             all                    trust

Save the changes and exit.

Now, restart PostgreSQL services by running the command below:

sudo service postgresql restart

That’s all

If you find any error and issue in above steps , please use comment box below to report.

If our article helps you, please consider buying us a coffee

Thank you for your support.

The post How to Install and Setup Odoo on Ubuntu Linux appeared first on Linux Tutorial Hub.

Leave a Comment

Your email address will not be published. Required fields are marked *