📄 Встановлення Odoo на власному комп'ютері — покроково

Встановлення Odoo на власному комп'ютері — покроково

Для тих, хто хоче спробувати кадровий і військовий облік самостійно, без витрат.

Ця інструкція показує, як поставити Odoo 19 Community (безкоштовну редакцію) на звичайний комп'ютер і встановити наші українські кадрові модулі. Нічого платити не треба — усе, що тут описано, безкоштовне.

Є два шляхи. Оберіть один:

  • Варіант A — інсталятор для Windows. Найпростіший. Odoo встановлюється як звичайна програма, усе всередині (Python, база даних, генератор PDF) вже вбудоване. Рекомендуємо для більшості.
  • Варіант B — WSL (Ubuntu всередині Windows). Для тих, хто хоче «як на сервері» / ближче до реального робочого середовища.

Кому локальної установки достатньо, а кому вже потрібен сервер

Odoo — це серверна система, навіть коли вона стоїть на вашому комп'ютері. Тож усе залежить від масштабу:

Ви ФОП або маленька команда (приблизно до 5 осіб), працюєте з одного комп'ютера. Локальної установки цілком достатньо для реальної щоденної роботи — не лише «спробувати». Пам'ятайте лише про три речі:

  • Сервіс має бути запущений. Odoo працює як служба у фоні. У Варіанті A (Windows) вона встановлюється як служба й стартує разом із комп'ютером автоматично. У Варіанті B (WSL) сервіс треба запускати вручну після кожного ввімкнення: sudo service postgresql start і sudo service odoo start. Якщо Odoo раптом «не відкривається» — найчастіше просто не запущений сервіс.
  • Робіть резервні копії. Дані лежать на цьому одному комп'ютері. Періодично експортуйте базу (Керування базами → Backup) і зберігайте копію окремо — щоб не втратити все, якщо з диском щось станеться.
  • Доступ — лише з цієї машини (localhost). Одна людина, один комп'ютер — усе добре.

Ваша компанія зростає — кілька людей працюють одночасно, потрібен доступ із різних пристроїв чи віддалено, важлива безперебійність і безпека. Тоді вже потрібен окремий сервер (VPS або офісний) з одночасним доступом по мережі, автоматичними бекапами, доменом і SSL, та кимось, хто це супроводжує. Локальний комп'ютер тут швидко впреться в стелю. Це вже наш формат «Під ключ» — див. тарифи на сайті; за потреби перенесемо вашу локальну базу на сервер без втрати даних.

Що знадобиться

  • Windows 10 (версія 2004+) або Windows 11.
  • ~4 ГБ вільного місця, бажано 8 ГБ оперативної пам'яті.
  • Права адміністратора на комп'ютері.

Odoo 19 вимагає Python 3.10+ і PostgreSQL 13+ — але у Варіанті A все це вже вбудоване в інсталятор, окремо ставити не потрібно.

Варіант A — Windows (інсталятор)

Крок 1. Завантажте інсталятор

Відкрийте офіційну сторінку завантаження:

  • odoo.com/page/download → оберіть Community, версію 19.0, платформу Windows.
  • Або напряму з нічного сервера збірок: nightly.odoo.com → 19.0 → windows.

Завантажиться файл виду odoo_19.0.latest.exe.

Беріть саме Community — вона безкоштовна й для наших кадрових/військових модулів її вистачає. Enterprise потрібна лише для модуля нарахування зарплати.

Крок 2. Запустіть встановлення

  1. Двічі клацніть завантажений .exe.
  2. Windows може показати синє вікно «Система Windows захистила ваш ПК». Це нормально для інсталяторів. Натисніть «Докладніше» → «Виконати в будь-якому разі».
  3. Оберіть мову встановлення, прийміть ліцензію.
  4. На кроці вибору компонентів залиште все як є — інсталятор сам поставить PostgreSQL (базу даних) разом з Odoo.
  5. Натисніть Install і дочекайтеся завершення. Наприкінці — Finish.

Після встановлення Odoo запуститься автоматично як служба Windows.

Крок 3. Відкрийте Odoo

У браузері перейдіть за адресою:

http://localhost:8069

Ви побачите екран створення першої бази даних. → Перейдіть до розділу «Перший запуск» нижче.

Варіант B — WSL (Ubuntu всередині Windows)

WSL — це «Linux всередині Windows». Установка займає трохи більше кроків, зате середовище ближче до справжнього сервера.

Крок 1. Увімкніть WSL і поставте Ubuntu

Відкрийте PowerShell від імені адміністратора (клацніть «Пуск» → напишіть PowerShell → правою кнопкою → Запуск від імені адміністратора) і виконайте:

wsl --install -d Ubuntu-24.04

Перезавантажте комп'ютер, коли попросить. Після перезапуску відкриється вікно Ubuntu — придумайте ім'я користувача й пароль (пароль при введенні не відображається, це нормально).

Крок 2. Оновіть систему

У вікні Ubuntu:

sudo apt update && sudo apt upgrade -y

Крок 3. Поставте базу даних PostgreSQL

sudo apt install postgresql -y
sudo service postgresql start

Крок 4. Встановіть Odoo 19 з офіційного пакета

Завантажте свіжий .deb для версії 19.0 (він розрахований саме на Ubuntu 24.04) і встановіть:

wget https://nightly.odoo.com/19.0/nightly/deb/odoo_19.0.latest_all.deb
sudo apt install ./odoo_19.0.latest_all.deb -y

Якщо посилання не спрацює — точну назву файлу подивіться на nightly.odoo.com/19.0/nightly/deb/ і підставте її замість odoo_19.0.latest_all.deb.

Пакет сам створить службу Odoo, потрібного користувача бази й запустить сервер.

Крок 5. Додайте генератор PDF (для друкованих форм)

Друковані форми (Додаток 4, Додаток 5 тощо) формуються у PDF, тому потрібен wkhtmltopdf із «пропатченим Qt». Візьміть збірку під вашу версію Ubuntu зі сторінки релізів github.com/wkhtmltopdf/packaging/releases і встановіть, наприклад:

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

Потім перезапустіть Odoo:

sudo service odoo restart

Крок 6. Відкрийте Odoo (важливий нюанс мережі WSL)

WSL — це окрема віртуальна машина зі своєю мережею. Тому з боку Windows localhost вказує на саму Windows, а не на WSL. Через це відкриття Odoo має свої тонкощі.

1. Спробуйте спочатку у браузері Windows:

http://localhost:8069

Windows має вбудований проброс localhost у WSL, і часто цього достатньо (Odoo слухає на всіх інтерфейсах). Якщо відкрилось — усе гаразд, переходьте до створення бази.

2. Якщо «не вдається під'єднатися» / порожня сторінка — проброс localhost у WSL2 буває нестабільним (особливо після сну чи перезапуску комп'ютера). Дізнайтеся IP-адресу WSL — у вікні Ubuntu виконайте:

hostname -I

Отримаєте щось на кшталт 172.28.144.10. Відкрийте у браузері Windows цю адресу з портом:

http://172.28.144.10:8069

⚠️ Ця адреса змінюється при кожному перезапуску WSL. Тож або дивіться hostname -I щоразу, або налаштуйте «дзеркальний» режим (пункт 3).

3. Щоб localhost працював стабільно (Windows 11) — увімкніть дзеркальний режим мережі. Створіть (або відредагуйте) файл C:\Users\<ВашеІм'я>\.wslconfig з таким вмістом:

[wsl2]
networkingMode=mirrored

Збережіть, потім у PowerShell виконайте wsl --shutdown і запустіть Ubuntu знову. Після цього http://localhost:8069 працюватиме напряму, а IP шукати більше не доведеться.

Перший запуск: створення бази даних

На першому екрані заповніть:

  • Master Password — головний пароль керування базами. Придумайте й збережіть його (знадобиться, щоб створювати/видаляти бази).
  • Database Name — назва бази, наприклад test.
  • Email — ваш логін для входу.
  • Password — пароль для входу.
  • Language — Українська.
  • Country — Україна (важливо: підтягне українську валюту й формати).
  • Demo data — можна поставити галочку, якщо хочете приклади для ознайомлення.

Натисніть Create database. Через хвилину відкриється ваша Odoo.

Встановлення наших кадрових і військових модулів

Наші модулі не входять у стандартний набір Odoo, тож їх треба додати. Найпростіший шлях:

Крок 1. Завантажте модулі

Зайдіть на нашу сторінку в Odoo App Store (видавець Golodaeva Olga) або на GitHub (@PeleOlala) і завантажте безкоштовні модулі. Для базового кадрового + військового обліку це, наприклад:

  1. l10n_ua_hr_employee — картка працівника (основа, треба встановити першою)
  2. l10n_ua_hr_employee_military — військовий облік
  3. l10n_ua_hr_employee_family — сімейний стан
  4. l10n_ua_hr_job_classifier — класифікатор професій

Точний перелік і назви безкоштовних модулів дивіться на сторінках наших додатків — там завжди актуальний склад.

Крок 2. Покладіть їх у папку додатків (addons)

Розпакуйте кожен модуль (щоб вийшла папка з назвою модуля, а всередині — __manifest__.py) і покладіть у папку додатків Odoo:

  • Windows (Варіант A): створіть окрему папку, напр. C:\odoo-custom-addons, і покладіть модулі туди. Потім у файлі odoo.conf (у теці встановлення Odoo) допишіть цю папку в рядок addons_path через кому. Перезапустіть службу Odoo (Пуск → Services → Odoo → Restart).
  • WSL (Варіант B): створіть папку mkdir ~/odoo-custom-addons, покладіть модулі туди, у /etc/odoo/odoo.conf додайте її до addons_path, і sudo service odoo restart.

Крок 3. Оновіть список додатків і встановіть

  1. У Odoo увімкніть Режим розробника: Налаштування → унизу → Активувати режим розробника.
  2. Відкрийте меню Додатки (Apps).
  3. Натисніть Оновити список додатків (Update Apps List).
  4. Приберіть фільтр «Apps» у пошуку, знайдіть l10n_ua, і натисніть Встановити — почніть з l10n_ua_hr_employee, потім решту.

Готово — у вас працює українська картка працівника, військовий облік і друковані форми.

Часті питання

Odoo не відкривається на localhost:8069. Спершу перевірте, що служба запущена. Windows: Пуск → Services → знайдіть Odoo → Start. WSL: sudo service postgresql start і sudo service odoo start. Якщо в WSL служба працює, а localhost:8069 усе одно не відкривається — це особливість мережі WSL: скористайтеся IP з hostname -I (http://172.x.x.x:8069) або увімкніть дзеркальний режим мережі. Детально — у Кроці 6 Варіанту B.

Друкована форма не формується / порожній PDF. Не встановлено або встановлено «непропатчений» wkhtmltopdf. У Варіанті A він вбудований; у Варіанті B поставте його за Кроком 5.

Чи можна так працювати «по-справжньому»? Так, якщо ви ФОП або маленька команда до ~5 осіб і працюєте з одного комп'ютера — локальної установки вистачає для щоденної роботи (не забувайте про запущений сервіс і бекапи). Коли людей стає більше, потрібен доступ із різних пристроїв чи безперебійність — час переходити на окремий сервер. Деталі — у розділі «Кому локальної установки достатньо…» вище; переїзд на сервер — це наш формат «Під ключ».

Коли простіше звернутися до нас

Самостійне встановлення — чудовий спосіб спробувати. Але якщо не хочеться витрачати час на технічні дрібниці або потрібні друковані форми «щоб просто працювало» — ми:

  • поставимо модулі на вашу вже наявну Odoo (від 4 000 грн);
  • зробимо кадровий і військовий облік під ключ (від 20 000 грн — це у 2 рази дешевше за повний Enterprise-проєкт);

Пишіть: olga@golodaeva.org.ua

Успіхів! І пам'ятайте: почати можна безкоштовно — а далі як піде.