Odoo 19: Kompletna instrukcja instalacji dla Ubuntu 24.04 (Community & Enterprise)

Wprowadzenie

Wdrożenie systemu ERP często wydaje się skomplikowanym zadaniem, ale odpowiednia architektura zmienia ten proces w przejrzysty algorytm. W tym przewodniku omówimy, jak skonfigurować Odoo 19 na świeżym Ubuntu 24.04 przy użyciu metody instalacji źródłowej w izolowanym środowisku wirtualnym.

Główną zaletą tej metody jest jej wszechstronność. Tworzymy strukturę folderów i uprawnień, która pozwala na uruchomienie darmowej wersji Community przy jednoczesnym zachowaniu możliwości natychmiastowej aktualizacji do wersji Enterprise poprzez proste dodanie modułów do folderu addons. Żadnych ręcznych hacków - tylko czysty przepływ pracy Python venv i automatyczny SSL za pośrednictwem Caddy.

Stos techniczny (zweryfikowany):

• System operacyjny: Ubuntu 24.04 LTS
• Środowisko: Python 3.12 (środowisko wirtualne)
• Serwer WWW: Caddy (automatyczny HTTPS i proxy)
• Baza danych: PostgreSQL 16.11
• Specyfikacje maszyny wirtualnej: 2 vCPU, 4 GB RAM, 40 GB NVMe

Krok 1: Przygotowanie systemu

Zaktualizuj system:

sudo apt update && sudo apt upgrade -y

Zainstaluj wymagane pakiety:

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

Krok 2: Baza danych (PostgreSQL)

Zainstaluj PostgreSQL i utwórz użytkownika bazy danych:

sudo apt install -y postgresql # Create the DB user sudo -u postgres createuser -s odoo19

Krok 3: Użytkownik systemowy i kod źródłowy

Utwórz użytkownika odoo19 i pobierz gałąź 19.0:

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

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

Krok 4: Wirtualne środowisko (wymagane dla 24.04)

Pozostając w sesji użytkownika odoo19:

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

Zakończ sesję odoo19:

exit

Krok 5: Generator PDF (wkhtmltopdf)

W przypadku Ubuntu 24.04 zaleca się użycie pakietu z wersji Jammy (22.04) lub pobranie aktualnej wersji binarnej, ponieważ domyślne repozytoria mogą nie obsługiwać 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

Krok 6: Konfiguracja

Utwórz plik konfiguracyjny i ustaw silne hasło admin_passwd. Będzie to potrzebne do pierwszego logowania i inicjalizacji bazy danych:

sudo nano /etc/odoo19.conf

Wstaw następującą konfigurację:

[options] 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

Ustaw uprawnienia:

# Create log directory and empty log file sudo mkdir /var/log/odoo # Transfer ownership to odoo19 user sudo chown odoo19:odoo19 /var/log/odoo sudo chown odoo19:odoo19 /etc/odoo19.conf # Restrict access to the config (owner and group only) sudo chmod 640 /etc/odoo19.conf

Krok 7: Automatyzacja (Systemd)

Utwórz plik usługi:

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

Wstaw następującą konfigurację:

[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

Uruchom usługę:

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

Krok 8: Konfiguracja odwrotnego proxy - Caddy

Zainstaluj oficjalne repozytorium Caddy dla 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

Konfiguracja Odoo dla odwrotnego proxy

Upewnij się, że proxy_mode = True znajduje się w pliku /etc/odoo19.conf (tak jak w kroku 6), a następnie uruchom ponownie Odoo:

sudo nano /etc/odoo19.conf

sudo systemctl restart odoo19

Konfiguracja pliku Caddyfile

sudo nano /etc/caddy/Caddyfile

Wstaw następujący blok:

# Replace :80 with YOUR_DOMAIN for automatic SSL :80 { request_body { max_size 300MB } # Longpolling reverse_proxy /longpolling/* localhost:8072 # Main traffic reverse_proxy localhost:8069 { header_up X-Forwarded-Host {host} header_up X-Forwarded-Proto {scheme} header_up X-Real-IP {remote_host} } }

Zatwierdź i uruchom ponownie Caddy:

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

sudo systemctl restart caddy

Krok 9: Pierwsze logowanie

Przejdź do:

• Via IP: http://YOUR_SERVER_IP
• Przez domenę: https://YOUR_DOMAIN (jeśli skonfigurowano w Caddy)

Wypełnij formularz tworzenia bazy danych:

• Hasło główne: Użyj hasła utworzonego w kroku 6.
• Nazwa bazy danych: np. mycompany.
• Email: Adres e-mail logowania.
• Hasło: hasło dostępu do systemu.
• Język i kraj: Wybierz odpowiednio.
• Dane demonstracyjne: Pozostaw niezaznaczone dla czystej produkcyjnej bazy danych.

Kliknij Utwórz bazę danych i poczekaj (1-2 minuty).

Konfiguracja nazwy domeny

Aby włączyć automatyczny SSL przez Let's Encrypt:

Krok 1. Ustaw DNS: Skieruj rekord A z YOUR_DOMAIN na adres IP serwera.

Krok 2. Edytuj plik Caddyfile: Zamień :80 na YOUR_DOMAIN.

Krok 3. Uruchom ponownie Caddy:

sudo systemctl restart caddy

Caddy automatycznie dostarczy certyfikat SSL. Uzyskaj dostęp do Odoo pod adresem https://YOUR_DOMAIN.