How to install Odoo 17 on Ubuntu 24.04

Install Odoo prerequisites

To install Odoo 17 on Ubuntu 24.04, you first need to install some essential software like Git, Node.js, and Pip. These programs help Odoo run correctly on your system.

Run the commands below to install supporting dependencies for Odoo.

sudo apt update
sudo apt install build-essential wget git python3.11-dev python3.11-venv libfreetype-dev libxml2-dev libzip-dev libsasl2-dev node-less libjpeg-dev zlib1g-dev libpq-dev libxslt1-dev libldap2-dev libtiff5-dev libopenjp2-7-dev libcap-dev

If you run into problems and can’t install python3.11, run the command below and try again.

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa

Create an Odoo system user on Ubuntu

Creating a special user account just for Odoo, called ‘odoo’, is important for security when you install Odoo 17 on Ubuntu 24.04. This stops you from running Odoo with the main administrator (root) rights.

To create a system account for Odoo, run the command below to create a system account called odoo.

The account home directory will be /opt/odoo17

sudo /usr/sbin/adduser --system --shell /bin/bash --gecos 'Odoo user' --group --home /opt/odoo17 odoo17

Install PostgreSQL on Ubuntu

Odoo 17 needs PostgreSQL to store all its information, so installing this database program is a necessary step to install Odoo 17 on Ubuntu 24.04. You’ll also need to turn it on and make sure it’s running.

sudo apt install postgresql

After installing the database server, enable and start it by running the commands below.

sudo systemctl enable --now postgresql.service

Next, create a PostgreSQL database account for Odoo. Run the commands below to create a new database account called odoo17.

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

Additional PostgreSQL help at the link below.

Install PostgreSQL on Ubuntu

Install Wkhtmltopdf on Ubuntu

To ensure Odoo 17 can generate PDF reports correctly on Ubuntu 24.04, you need to install the Wkhtmltopdf package, which helps render HTML into PDFs.

Check this link to ensure you always get the latest version.

To install the package, run the commands below.

sudo apt install wkhtmltopdf

Install and configure Odoo17 on Ubuntu

Now that you’ve set up the basics, you can download and install Odoo 17 on Ubuntu 24.04. The first step is to switch to the special ‘odoo’ user account you created earlier.

The first thing you’ll want to do is switch to the Odoo system account we created above by running the commands below:

sudo su - odoo17

Odoo’s latest version is 17 at the time of this post. If a newer version is available, you should clone that instead. To clone Odoo version 17, run the commands below.

Check this link to ensure you always get the latest version.

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

When the download is complete, change it into Odoo’s directory and run the commands below to configure and install all Odoo17 requirements.

cd /opt/odoo17
python3.11 -m venv odoo17-venv
source odoo17-venv/bin/activate
pip3 install wheel setuptools pip --upgrade
pip3 install -r odoo17/requirements.txt
deactivate

After that, create a new directory for Odoo custom addons.

mkdir /opt/odoo17/odoo17/custom-addons

Exit:

exit

When done, add the Odoo admin password, database name, and database account name to its configuration file.

Run the commands below to open Odoo’s configuration file.

sudo nano /etc/odoo17.conf

Then copy and paste the lines below into the file, save, and exit.

[options]
admin_passwd = Type_strong_password_here
db_host = False
db_port = False
db_user = odoo17
db_password = False
addons_path = /opt/odoo17/odoo17/addons,/opt/odoo17/odoo17/custom-addons

Replace Type_strong_password_here with something more complex and more robust. This password is the master password you’ll need when setting up Odoo.

Save your changes and exit.

Create a Systemd unit file on Ubuntu

A systemd unit file for Odoo 17 on Ubuntu 24.04 helps you manage Odoo like a service. This means you can easily start, stop, or restart Odoo whenever you need to.

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

Then copy and paste the lines below into the file, save, and exit

[Unit]
Description=Odoo17
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo17
PermissionsStartOnly=true
User=odoo17
Group=odoo17
ExecStart=/opt/odoo17/odoo17-venv/bin/python3 /opt/odoo17/odoo17/odoo-bin -c /etc/odoo17.conf
StandardOutput=journal+console

[Install]
WantedBy=multi-user.target

When you’re done, reload the systemd daemon and start the Odoo service.

sudo systemctl daemon-reload
sudo systemctl enable --now odoo17

To check Odoo status and verify it’s installed and running, run the commands below:

sudo systemctl status odoo17

You should see similar messages below:

odoo17.service - odoo17
     Loaded: loaded (/etc/systemd/system/odoo17.service; enabled; preset: enabl>
     Active: active (running) since Wed 2024-06-05 07:07:56 CDT; 7s ago
   Main PID: 10898 (python3)
      Tasks: 2 (limit: 4561)
     Memory: 92.8M (peak: 93.2M)
        CPU: 1.436s
     CGroup: /system.slice/odoo17.service
             └─10898 /opt/odoo17/odoo17-venv/bin/python3 /opt/odoo17/odoo17/odo>

Jun 05 07:07:58 Ubuntu2404 odoo17[10898]:   File "/opt/odoo17/odoo17/odoo/tools>
Jun 05 07:07:58 Ubuntu2404 odoo17[10898]:     return func(inst, *args, **kwargs)

That should be done if you follow and complete all the steps above.

Access Odoo web UI

Once Odoo 17 is set up on Ubuntu 24.04, you can open it in your web browser. Just go to your server’s address followed by port 8069, like http://localhost:8069, to see the Odoo setup page.

http://localhost:8069

You should then see the Odoo setup page. Use the master password you created in the/etc/odoo.conf file. Then, type a new database name, admin email address, and password.

Then, click Create Database.

Once everything is entered correctly, you can complete the setup and start using Odoo.

For those who run into issues such as Internal server errors or errors when opening the Odoo setup wizard, they should configure PostgreSQL to trust all local connections.

Run the commands below to open the PostgreSQL configuration file.

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

Replace the version number with the version installed on your system.

Then, change the highlighted line in the file and save it.

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

Replace MD5 or Peer with trust. Save and exit, then restart PostgreSQL.

sudo service postgresql restart

If you want to use a reverse proxy with Odoo, click either link below to set up a reverse proxy with Nginx or Apache.

How to setup reverse proxy with Nginx

How to setup reverse proxy with Apache

That should do it!

Conclusion:

• Ease of Installation: Setting up Odoo 17 on Ubuntu 24.04 is straightforward, thanks to the comprehensive step-by-step guide provided.
• Robust Platform: Ubuntu’s reliability, support, and security features make it an ideal environment for deploying and running Odoo.
• Community Support: The well-supported Ubuntu platform, combined with the extensive support from the Odoo community, ensures a smooth installation and ongoing usage.
• Further Assistance: If any errors or additional details need to be included, please utilize the comments section below the post for support and further clarification.