Odoo is an opensource all-in-one business management software that ships with a suite of various business applications for various uses such as eCommerce, project management, helpdesk, accounting, inventory, and a website builder to mention a few.
In this article, you will learn how to install Odoo (Open Source ERP and CRM) on CentOS 8 and RHEL 8.
Step 1: Update the System and Install EPEL Repository
1. The first step in installing Odoo is to install the EPEL repository that provides a set of extra packages for enterprise Linux. But first, be sure to update the system as shown.
$ sudo dnf update
2. Once the update of the system is complete, install the EPEL repository as shown.
$ sudo dnf install epel-release
Step 2: Install Python3 and Other Dependencies
3. Next, install Python 3 and other requisite dependencies that are required by Odoo as shown.
$ sudo dnf install python36 python36-devel git gcc wget nodejs libxslt-devel bzip2-devel openldap-devel libjpeg-devel freetype-devel
Step 3: Install and Configure PostgreSQL in CentOS 8
4. PostgreSQL is a free and opensource relational database management system used in a vast array of applications to store data. We need to install PostgreSQL for Odoo and to do this, run the command.
$ sudo dnf install postgresql-server postgresql-contrib
5. Next, initialize a new PostgreSQL database cluster.
$ sudo postgresql-setup initdb
6. Once the database cluster has been initialized, restart, and enable PostgreSQL as shown.
$ sudo systemctl restart postgresql $ sudo systemctl enable postgresql
7. To confirm that the database is up and running, execute.
$ sudo systemctl status postgresql
Step 4: Install the Wkhtmltopdf Tool in CentOS 8
8. For Odoo to print PDF reports, it requires a package called Wkhtmltopdf. This is used to render HTML to PDF and other image formats. The rpm package is available on Github and you can install it as shown.
$ sudo dnf install https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos8.x86_64.rpm
Step 5: Install and Configure Odoo in CentOS 8
9. We will add a new system user that we will use to run the Odoo service. In this illustration, we will create a user called Odoo, however, feel free to choose an arbitrary username. The home directory is located in the
$ sudo useradd -m -U -r -s /bin/bash odoo -d /opt/odoo
10. To begin installing Odoo, first switch to the Odoo user that we created above.
$ sudo su - odoo
11. Then clone the git repository.
$ git clone https://www.github.com/odoo/odoo --depth 1 --branch 13.0 /opt/odoo/odoo13
12. Next, clone the virtual environment as shown.
$ cd /opt/odoo $ python3 -m venv odoo13-venv
13. Once the virtual environment is created, activate it using the following command.
$ source odoo13-venv/bin/activate
As you can observe, the prompt changes as shown.
14. Inside the virtual environment, install the required Python modules for the installation of Odoo to go smoothly.
$ pip3 install -r odoo13/requirements.txt
15. Once the installation of the Python modules is complete, exit the virtual environment and go back to the sudo user.
$ deactivate && exit
16. Although optional. Best practice dictates the installation of custom modules in a separate directory. With that in mind, we will proceed to create a directory for custom modules and later assign the directory ownership to the ‘Odoo‘ user.
$ sudo mkdir /opt/odoo/odoo13-custom-addons $ sudo chown -R odoo:odoo /opt/odoo/odoo13-custom-addons
17. In the same way, we will create a custom log directory and log file as shown.
$ sudo mkdir /var/log/odoo13 $ sudo touch /var/log/odoo13/odoo.log $ sudo chown -R odoo:odoo /var/log/odoo13/
18. Next, create a custom configuration file for Odoo as shown.
$ sudo vim /etc/odoo.conf
Paste the following configuration and save the file.
[options] ; This is the password that allows database operations: admin_passwd = strong_password db_host = False db_port = False db_user = odoo db_password = False xmlrpc_port = 8069 ; longpolling_port = 8072 logfile = /var/log/odoo13/odoo.log logrotate = True addons_path = /opt/odoo/odoo13/addons,/opt/odoo/odoo13-custom-addons
Be sure to replace the strong_password with your preferred password.
Step 6: Create an Odoo Systemd Unit File
19. Now, create a systemd unit file for Odoo.
$ sudo vim /etc/systemd/system/odoo13.service
Paste the following configuration and save the file.
[Unit] Description=Odoo13 #Requires=postgresql-10.6.service #After=network.target postgresql-10.6.service [Service] Type=simple SyslogIdentifier=odoo13 PermissionsStartOnly=true User=odoo Group=odoo ExecStart=/opt/odoo/odoo13-venv/bin/python3 /opt/odoo/odoo13/odoo-bin -c /etc/odoo.conf StandardOutput=journal+console [Install] WantedBy=multi-user.target
20. Reload systemd of the new changes made to the file.
$ sudo systemctl daemon-reload
21. Then start and enable Odoo as shown.
$ sudo systemctl start odoo13 $ sudo systemctl enable odoo13
22. To confirm the status of Odoo, run the command:
$ sudo systemctl status odoo13
23. You can also use the netstat command to check if Odoo is listening on port 8069 – which is its default port.
$ sudo netstat -pnltu | grep 8069
24. For Odoo to be accessible on a browser, open the port across the firewall.
$ sudo firewall-cmd --add-port=8069/tcp --zone=public --permanent $ sudo firewall-cmd --reload
Step 7: Install Nginx as Reverse Proxy for Odoo
25. Finally, we will install the Nginx web server which will act as a reverse proxy to our Odoo instance. So, run the command:
$ sudo dnf install nginx
26. Next, create a new virtual host file.
$ sudo vim /etc/nginx/conf.d/odoo13.conf
and paste the following configuration as shown.
Save and exit the configuration file.
27. Now start and enable Nginx webserver.
$ sudo systemctl start nginx $ sudo systemctl enable nginx
28. Confirm that Nginx is running as shown.
$ sudo systemctl status nginx
At this point, we are all done with the configuration. The last step is to finalize the setup on a web browser.
Step 8: Finalizing Odoo Setup
29. Launch a web browser and visit your server’s IP as shown.
A similar web page to the one below will be displayed. For the master password, use the password specified in Step 5 while creating a custom Odoo config file. Then proceed to fill out all the other entries and click on the ‘Create database’ button.
30. This ushers you to Odoo’s dashboard showing the various applications that can be installed.
And this wraps up our tutorial for today. In this guide, you learned how to install Odoo on CentOS 8.