How To Install Odoo on Linux Mint 22

In this tutorial, we will show you how to install Odoo on Linux Mint 22. Odoo is a powerful open-source ERP (Enterprise Resource Planning) solution that integrates various business applications such as CRM, accounting, inventory management, and more. Installing Odoo on Linux Mint 22 can significantly enhance your business operations by providing a unified platform for managing different aspects of your business. This comprehensive guide will walk you through the step-by-step process of installing Odoo on Linux Mint 22, ensuring a smooth and efficient setup.

Prerequisites

System Requirements

• RAM: At least 2GB.
• Storage: Minimum of 20GB free space.
• Operating System: Linux Mint 22 installed and updated.
• User Privileges: Root or sudo user access.

Dependencies Overview

Before installing Odoo, it’s essential to install the necessary dependencies that enable Odoo to function correctly. These dependencies include Python3, pip, PostgreSQL, build-essential libraries, and wkhtmltopdf, which is crucial for generating PDFs in Odoo.

Update System

Ensure your system is up-to-date by running the following command:

sudo apt update && sudo apt upgrade -y

This command updates the package lists and upgrades the installed packages to their latest versions, ensuring compatibility and stability for the Odoo installation.

Step-by-Step Installation Process

Step 1: Install Required Dependencies

Odoo relies on several dependencies to function seamlessly. Installing these dependencies beforehand eliminates potential issues during the installation process.

Run the following command to install the necessary packages:

sudo apt install git python3-pip build-essential wget python3-dev python3-venv \
libfreetype6-dev libxml2-dev libzip-dev libldap2-dev libsasl2-dev \
python3-setuptools node-less libjpeg-dev zlib1g-dev libpq-dev \
libxslt1-dev libtiff5-dev libopenjp2-7-dev liblcms2-dev

This command installs essential libraries and tools required by Odoo, ensuring all necessary components are available.

Step 2: Set Up PostgreSQL

PostgreSQL is the database backend for Odoo. Setting it up correctly is crucial for the smooth operation of Odoo.

Install PostgreSQL using the following command:

sudo apt install postgresql -y

Start and enable the PostgreSQL service:

sudo systemctl start postgresql
sudo systemctl enable postgresql

Create a PostgreSQL user for Odoo:

sudo su - postgres
createuser --createdb --username postgres --no-createrole --no-superuser odoo

Exit the PostgreSQL user shell:

exit

Step 3: Download and Install Odoo

Download the latest stable version of Odoo from the official GitHub repository.

Clone the Odoo repository:

cd /opt
sudo git clone https://www.github.com/odoo/odoo --depth 1 --branch 17.0 odoo17

Create a Python virtual environment and activate it:

cd /opt/odoo17
python3 -m venv odoo17-venv
source odoo17-venv/bin/activate

Upgrade pip and install required Python packages:

pip install --upgrade pip
pip install wheel
pip install -r requirements.txt

Deactivate the virtual environment after installation:

deactivate

Create a system user for Odoo:

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

Step 4: Configure Odoo

Create and edit the Odoo configuration file:

sudo nano /etc/odoo17.conf

Paste the following configuration, replacing YourStrongPasswordHere with a secure password:

[options]
admin_passwd = YourStrongPasswordHere
db_host = False
db_port = False
db_user = odoo17
db_password = False
xmlrpc_port = 8069
logfile = /var/log/odoo17/odoo17.log
addons_path = /opt/odoo17/odoo17/addons,/opt/odoo17/odoo17-custom-addons

Create the log directory and set appropriate permissions:

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

Set the correct permissions for the configuration file:

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

Restart the Odoo service to apply the changes:

sudo systemctl restart odoo17

Step 5: Install Wkhtmltopdf

Wkhtmltopdf is necessary for generating PDF reports in Odoo. Install it using the following commands:

Navigate to the temporary directory:

cd /tmp

Download the wkhtmltopdf package:

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb

Install the downloaded package using gdebi to handle dependencies:

sudo gdebi -n wkhtmltox_0.12.6.1-3.jammy_amd64.deb

Remove the downloaded package to clean up:

rm wkhtmltox_0.12.6.1-3.jammy_amd64.deb

Create a symbolic link for wkhtmltopdf:

sudo ln -s /usr/local/bin/wkhtmltopdf /usr/bin/

Verify the installation by checking the version:

wkhtmltopdf --version

Post-Installation Steps

Accessing the Odoo Web Interface

Once the installation is complete, you can access the Odoo web interface through your web browser.

Open your browser and navigate to:

http://localhost:8069

You will be greeted with the initial setup wizard. Follow the prompts to create an admin account and configure your first database. This step finalizes the installation and prepares Odoo for use.

Testing the Installation

To ensure that Odoo is functioning correctly, perform a few test tasks:

• Create a new customer record.
• Set up a sales order.
• Generate a PDF invoice.

Successfully completing these tasks confirms that Odoo is properly installed and operational on your system.

Setting Up Auto-start

To ensure that Odoo starts automatically on system boot, enable the Odoo service using the following command:

sudo systemctl enable odoo17

This command configures the Odoo service to start automatically, ensuring uninterrupted access to the ERP system.

Troubleshooting Common Issues

Dependency Errors

If you encounter errors related to missing libraries or Python packages, ensure all dependencies are installed correctly. Re-run the dependency installation commands and verify that no errors occur during the process.

Service Not Starting

In cases where the Odoo service fails to start, check the service logs for detailed error messages:

sudo journalctl -u odoo17.service

Common issues include incorrect configuration settings or missing dependencies. Address any errors indicated in the logs to resolve the issue.

Database Connection Issues

Ensure that PostgreSQL is running and that the Odoo configuration file correctly references the PostgreSQL user and database. Verify the settings in /etc/odoo17.conf and ensure that the PostgreSQL service is active:

sudo systemctl status postgresql

Congratulations! You have successfully installed Odoo. Thanks for using this tutorial for installing the Odoo open source ERP on Linux Mint 22 system. For additional help or useful information, we recommend you check the official Odoo website.