Odoo 19: Повний гайд установки на Ubuntu 24.04 (Community & Enterprise)

Вступ

Розгортання ERP-системи часто здається складним завданням, але правильна архітектура перетворює цей процес на чіткий алгоритм. У цьому посібнику ми розберемо, як підняти Odoo 19 на свіжій Ubuntu 24.04, використовуючи метод встановлення з вихідного коду в ізольованому віртуальному оточенні.

Головна особливість цього методу – універсальність. Ми відразу закладаємо структуру папок та прав, яка дозволяє працювати на безкоштовній Community-версії, але дає можливість миттєво перейти на Enterprise-версію простим додаванням модулів до папки addons. Жодних правок – тільки чиста робота з Python venv та автоматичний SSL через Caddy.

Технічний стек, на якому перевірено цю інструкцію:

ОС: Ubuntu 24.04 LTS
Середовище: Python 3.12 (віртуальне середовище)
Веб-сервер: Caddy (автоматичний HTTPS та проксіювання)
База даних: PostgreSQL 16.11
Віртуальна машина: 2 vCPU, 4 ГБ ОЗУ, 40 ГБ NVMe

Info

Загалом дана інструкція може працювати з будь-якими версіями допоміжного ПЗ. Критичним тут є лише дистрибутив ОС Ubuntu 24.04 LTS.

Крок 1: Підготовка системи

Оновлення системи:

sudo apt update && sudo apt upgrade -y

Встановлення необхідних пакетів:

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

Крок 2: База даних (PostgreSQL)

Установка БД PostgreSQL та створення користувача

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

Крок 3: Системний користувач та вихідний код

Створимо користувача odoo19 та завантажимо гілку 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

Крок 4: Віртуальне оточення (обов'язково для 24.04)

Перебуваючи у сесії користувача 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

Вийдіть із сесії користувача Odoo19:

Крок 5: PDF-генератор (wkhtmltopdf)

Для Ubuntu 24.04 краще використовувати пакет від версії Jammy (22.04) або завантажити актуальний бінарний файл, тому що в штатних репозиторіях пакет може бути відсутнім або без підтримки 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

Крок 6: Конфігурація

Створіть файл та вкажіть надійний admin_passwd. Запам'ятайте його, він вам знадобиться під час першого входу та ініціалізації БД:

sudo nano /etc/odoo19.conf

Внесіть до нього конфігурацію:

[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

Встановити права:

# 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

Крок 7: Автозапуск (Systemd)

Створіть файл:

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

і вставте в нього конфігурацію:

[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

Запустіть службу:

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

Крок 8: Налаштування Reverse проксі – Caddy

Установка офіційного репозиторію Caddy для 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 sudo apt install caddy -y

Налаштування Odoo для роботи через проксі:

Потрібно додати рядок proxy_mode = True у файл конфігурації Odoo, якщо її там немає:

sudo nano /etc/odoo19.conf

Перезапуск Odoo:

sudo systemctl restart odoo19

Налаштування Caddyfile

Відкрийте конфігурацію Caddy:

sudo nano /etc/caddy/Caddyfile

І вставте в нього фрагмент коду:

# 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}
  }
}

Перевірка конфігурації Caddy та перезапуск сервера:

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

sudo systemctl restart caddy

Крок 9: Перший вхід

Відкрийте у браузері:

IP: http://IP_ВАШОГО_СЕРВЕРА
За доменом: https://ВАШ_ДОМЕН (Якщо він вже був налаштований у Caddyfile)

Заповніть форму створення бази даних:

Master Password: Це пароль з кроку №6, де створювався конфігураційний файл Odoo
Database Name: Наприклад, mycompany
Email: Ваш email, до якого ви маєте доступ – цей email буде логіном у систему
Password: Це буде ваш пароль для входу до системи
Language: Виберіть потрібний
Country Виберіть потрібну країну
Demo Data: Якщо потрібна чиста база, то не варто відзначати чекбокс