Odoo 19: Guida completa all'installazione per Ubuntu 24.04 (Comunità ed Impresa)

Introduzione

La distribuzione di un sistema ERP sembra spesso un compito complesso, ma la giusta architettura trasforma il processo in un chiaro algoritmo. In questa guida spiegheremo come configurare Odoo 19 su Ubuntu 24.04 utilizzando il metodo di installazione alla fonte in un ambiente virtuale isolato.

Il punto forte di questo metodo è la sua versatilità. Stabiliamo una struttura di cartelle e permessi che consente di eseguire la versione Community gratuita mantenendo la possibilità di passare immediatamente alla versione Enterprise semplicemente aggiungendo moduli alla cartella addons. Nessun hack manuale: solo un flusso di lavoro pulito in Python venv e un SSL automatico tramite Caddy.

Stack tecnico (verificato):

Sistema operativo: Ubuntu 24.04 LTS
Ambiente: Python 3.12 (ambiente virtuale)
Server web: Caddy (HTTPS e Proxying automatico)
Database: PostgreSQL 16.11
Specifiche della macchina virtuale: 2 vCPU, 4 GB di RAM, 40 GB NVMe

Info

In generale, questa guida funziona con varie versioni del software di supporto. Il componente critico è la distribuzione Ubuntu 24.04 LTS.

Passo 1: Preparazione del sistema

Aggiornare il sistema:

sudo apt update && sudo apt upgrade -y

Installare i pacchetti necessari:

sudo apt install -y git python3-pip python3-dev python3-venv \ 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 libwebp-dev libharfbuzz-dev libfribidi-dev \ libxcb1-dev nodejs npm

Passo 2: Database (PostgreSQL)

Installare PostgreSQL e creare un utente del database:

sudo apt install -y postgresql # Creare l'utente del database sudo -u postgres createuser -s odoo19

Passo 3: Utente di sistema e codice sorgente

Creare l'utente odoo19 e scaricare la versione 19.0:

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

git clone https://www.github.com/odoo/odoo --depth 1 --branch 19.0 /opt/odoo19/odoo

Passo 4: Ambiente virtuale (necessario per la versione 24.04)

Mentre si è ancora nella sessione utente di odoo19:

python3 -m venv odoo-venv source odoo-venv/bin/activate pip install --upgrade pip install wheel phonenumbers pip install -r /opt/odoo19/odoo/requirements.txt

Uscire dalla sessione di odoo19:

exit

Passo 5: Generatore di PDF (wkhtmltopdf)

Per Ubuntu 24.04, si consiglia di utilizzare il pacchetto della versione Jammy (22.04) o di scaricare il binario corrente, poiché i repository predefiniti potrebbero non supportare QT.

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb sudo apt install ./wkhtmltox_0.12.6.1-2.jammy_amd64.deb -y

Passo 6: Configurazione

Creare un file di configurazione e impostare una password_amministratore forte. Ne avrete bisogno per il primo login e per l'inizializzazione del database:

sudo nano /etc/odoo19.conf

Inserite la seguente configurazione:

[opzioni] admin_passwd = YOUR_SUPER_PASSWORD db_host = False db_port = False db_user = odoo19 db_password = False addons_path = /opt/odoo19/odoo/addons logfile = /var/log/odoo/odoo19.log proxy_mode = True

Impostare i permessi:

# Creare una directory di log e un file di log vuoto sudo mkdir /var/log/odoo # Trasferire la proprietà all'utente odoo19 sudo chown odoo19:odoo19 /var/log/odoo sudo chown odoo19:odoo19 /etc/odoo19.conf # Limitare l'accesso alla configurazione (solo proprietario e gruppo) sudo chmod 640 /etc/odoo19.conf

Passo 7: Automazione (Systemd)

Creare il file di servizio:

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

Inserire la seguente configurazione:

[Unit] Description=Odoo 19 After=network.target postgresql.service [Service] Type=simple User=odoo19 Group=odoo19 ExecStart=/opt/odoo19/odoo-venv/bin/python3 /opt/odoo19/odoo/odoo-bin -c /etc/odoo19.conf StandardOutput=journal+console [Install] WantedBy=multi-user.target

Avviare il servizio:

sudo systemctl daemon-reload sudo systemctl enable --now odoo19

Passo 8: Configurazione del proxy inverso - Caddy

Installare il repository ufficiale di Caddy per Ubuntu

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list sudo apt update sudo apt install caddy -y

Configurazione di Odoo per il reverse proxy

Assicurarsi che proxy_mode = True sia presente nel file /etc/odoo19.conf (come fatto al punto 6), quindi riavviare Odoo:

sudo nano /etc/odoo19.conf

sudo systemctl restart odoo19

Configurare il Caddyfile

sudo nano /etc/caddy/Caddyfile

Inserire il seguente blocco:

# Sostituire :80 con YOUR_DOMAIN per l'SSL automatico :80 { request_body { max_size 300MB } # Longpolling reverse_proxy /longpolling/* localhost:8072 # Traffico principale reverse_proxy localhost:8069 { header_up X-Forwarded-Host {host} header_up X-Forwarded-Proto {schema} header_up X-Real-IP {remote_host} } }

Convalidare e riavviare Caddy:

sudo caddy validate --config /etc/caddy/Caddyfile

sudo systemctl restart caddy

Passo 9: Accesso iniziale

Navigare su:

Via IP: http://YOUR_SERVER_IP
Via dominio: https://YOUR_DOMAIN (se configurato in Caddy)

Completare il modulo di creazione del database:

Password principale: utilizzare la password creata al punto 6.
Nome del database: ad esempio, mycompany.
Email: L'e-mail di accesso.
Password: la password di accesso al sistema.
Lingua e Paese: Selezionare come appropriato.
Dati demo: Lasciare deselezionato per ottenere un database di produzione pulito.

Fare clic su Crea database e attendere (1-2 minuti).