How to Install Odoo 15 on Ubuntu 20.04 LTS Server: Step-by-Step Guide

Learn how to install Odoo 15 on an Ubuntu 20.04 LTS server with our comprehensive step-by-step guide. Get your business management software up and running efficiently with this detailed tutorial.

Introduction:

In this article we well explain step by step how to install odoo on Ubuntu

Note: All of these steps will go through the terminal(Command Line Interface).

Requirements:

1. VPS with Ubuntu OS Peramix VPS

Installation procedure for Odoo:

Step-1: Login to the Server and Update

Login to the server using ssh: 

ssh <username>@<IP address>

eg: ssh [email protected]
Ensure that system is updated:

sudo apt-get update
sudo apt-get upgrade

Step 2: Secure Server

Ensure the system is secure from ssh attacks, the use of Fail2ban will help to prevent ssh attacks:

sudo apt-get install openssh-server fail2ban

Step 3: Install Python 3 and its Dependencies

Install python3 & PIP3

sudo apt-get install -y python3-pip

Then install Packages and libraries:

sudo apt-get install python-dev python3-dev libxml2-dev libxslt1-dev zlib1g-dev libsasl2-dev libldap2-dev build-essential libssl-dev libffi-dev libmysqlclient-dev libjpeg-dev libpq-dev libjpeg8-dev liblcms2-dev libblas-dev libatlas-base-dev

Make sure that all packages are installed correctly without any errors. After successful installation of Python packages, some web dependencies are also needed to be installed. 

sudo apt-get install -y npm
sudo ln -s /usr/bin/nodejs /usr/bin/node
sudo npm install -g less less-plugin-clean-css
sudo apt-get install -y node-less

Step 4: Setup Database Server(PostgreSQL)

Odoo uses PostgreSQL as its database server. Follow the steps to install and setup database server for Odoo:

sudo apt-get install postgresql

In the next step, create a Postgres user to handle the database. The user and given password are needed for the conf file later.Postgres has its own system user called ‘Postgres to perform the operations. So next command for change user to Postgres:

sudo su - postgres

Next, let's create a database user for Odoo15. When you enter the following command, it will ask for a password and re-enter it again. Remember this for later use:

createuser --createdb --username postgres --no-createrole --no-superuser --pwprompt odoo15

The following command ensures that the user has superuser access rights:

psql
ALTER USER odoo15 WITH SUPERUSER;

Exit from psql and Postgres user:

\q
exit

Step 5: System User 

Next let's create a system user to perform Odoo roles and also for security purposes. All the files and directories of Odoo’s access and operations will be limited for this user. 

Now let us create a new system user for the Odoo service and further then we will limit the permissions of all Odoo related files and directories for this specific user.

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

Step 6: Clone Odoo Source from GitHub Repository:

With the Community Edition source code, we can directly clone from Odoo’s GitHub repository. You can add the Enterprise edition add-ons after the installation process is completed.So first install git to the server:

sudo apt-get install git

Next, switch system user to ‘odoo’ and the files will be added into the user’s home directory:

sudo su - odoo -s /bin/bash

The following command will clone the source directory and the operator dot(.) at the end of the command is used to clone the files to the home directory of the current user which is /opt/odoo and is the same home directory mentioned at the time of user creation:

git clone https://www.github.com/odoo/odoo --depth 1 --branch 15.0 --single-branch .

Then exit from the user and continue the installation:

exit

Step 7: Install Required Python Packages

The next step is to install the required packages. All the packages are listed in the requirement.txt file. Therefore, we can easily install these packages with a single command:

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

To run Odoo smoothly, all the packages should be installed properly and you should ensure that.

Step 8: Install Wkhtmltopdf:

Odoo supports printing reports as PDF files. Wkhtmltopdf helps to generate PDF reports from HTML data format. Moreover, the Qweb template reports are converted to HTML format by the report engine and Wkhtmltopdf will produce the PDF report:

sudo wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb
sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb
sudo apt install -f


Step 9: Setup Conf file

Next, we have to configure the conf file for Odoo which contains certain necessary information such as the addons path, database-related parameters, proxy parameters, and many more. Therefore, you should create a configuration file inside the /etc directory. There is a sample conf file inside Odoo’s source, in the Debian directory. To copy from Debian to the /etc directory use the following command:

sudo cp /opt/odoo/debian/odoo.conf /etc/odoo.conf

This file contains sample values, and you should edit the file with proper values:

sudo nano /etc/odoo.conf

Update admin password and db_password from the following sample.

[options]
   This is the password that allows database operations:
   admin_passwd = admin
   db_host = False
   db_port = False
   db_user = odoo15
   db_password = False
   addons_path = /opt/odoo/addons
   logfile = /var/log/odoo/odoo.log

The following aspects should be configured before the operations are conducted:
db_user: the database user name.
db_password: provide db user password which is given while creating the db user.
admin_passwd: This is the master password of Odoo which is used to perform database operations in the database manager like create, delete, duplicate, and many more.
db_host: the database host.

db_port:  the database port.

addons_path: provide the path of directories that contain the Odoo addons directories. You can mention multiple directories separated by commas:Eg: addons_path = /opt/odoo/addons,  /opt/odoo/enterprise, /opt/odoo/custom

logfile: the log file path.

Finally, you should set access rights of the conf file for the system user odoo:

sudo chown odoo: /etc/odoo.conf
sudo chmod 640 /etc/odoo.conf

And create a log directory to store the log file of odoo which will help you to find Odoo related issues and also set permissions for the user odoo as we did earlier:

sudo mkdir /var/log/odoo
sudo chown odoo:root /var/log/odoo

Step 10: Odoo service file

Finally, we have to create a service to run Odoo. Let’s create a service file ‘odoo.service’ in /etc/systemd/system:

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

Add the following content to the newly created service file

[Unit]
   Description=Odoo
   Documentation=http://www.odoo.com
   [Service]
   # Ubuntu/Debian convention:
   Type=simple
   User=odoo
   ExecStart=/opt/odoo/odoo-bin -c /etc/odoo.conf
   [Install]
   WantedBy=default.target

Next set the permissions for the root user to this service file:

sudo chmod 755 /etc/systemd/system/odoo.service
sudo chown root: /etc/systemd/system/odoo.service

Step 11: Test Odoo

Now all the steps of installation are completed. Let's test the Odoo instance with the following command:

sudo systemctl start odoo.service

Then check the status of the service using the following command. And if it depicts as active, the installation of Odoo was successful:

sudo systemctl status odoo.service

Now you can access Odoo by entering the following URL:

“http://<your_domain_or_IP_address>:8069”

This will redirect you to the database creation page if everything is set up correctly.
Check Odoo logs
You can also check the logs of the Odoo platform that you have set up if you are facing any issues related to the installation or any other reasons with the following command. This command will show you the live logs in the terminal:

sudo tail -f /var/log/odoo/odoo.log

At last, if you want to start the Odoo service automatically after rebooting the server, use the following command:

sudo systemctl enable odoo.service

If you have made any changes in the addons, restart the Odoo service to reflect the updates on your instance using the following command:

sudo systemctl restart odoo.service


Summary:

In this blog  we explain for you how to install Odoo 15 on ubuntu 20.04.

Get Odoo installed on Peramix VPS Hosting with 1 click. Ready to use!

Administrator June 13, 2024
Share this post
Tags
Archive
Step-by-Step Guide: How to Install CyberPanel on Your Server or VPS
Learn how to easily install CyberPanel on your server or VPS with our step-by-step guide. Optimize your web hosting with this powerful, user-friendly control panel. Perfect for beginners and experienced users alike.