Встановлення з вихідного коду¶

«Встановлення» з вихідного коду не стосується встановлення Odoo, а полягає в його запуску безпосередньо з вихідного коду.

Використання вихідного коду Odoo може бути зручнішим для розробників модулів, оскільки він є легше доступним, ніж використання пакетних інсталяторів.

Це робить запуск і зупинку Odoo гнучкішими та зрозумілішими, ніж служби, налаштовані пакетними інсталяторами. Крім того, це дозволяє перевизначати налаштування за допомогою параметрів командного рядка без необхідності редагувати файл конфігурації.

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

Отримання вихідного коду¶

Існує два способи отримання вихідного коду Odoo: як ZIP-архів або через Git.

Архів¶

Редакція Community:

Редакція Enterprise:

Git¶

Примітка

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

Для клонування репозиторію Git виберіть між клонуванням через HTTPS або SSH. У більшості випадків найкращий варіант — HTTPS. Однак виберіть SSH для участі в розробці вихідного коду Odoo або під час виконання підручника для розробників Getting Started.

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

Примітка

Репозиторій git Enterprise не містить повного вихідного коду Odoo. Це лише колекція додаткових модулів. Основний код сервера знаходиться в редакції Community. Запуск версії Enterprise означає запуск сервера з версії Community з опцією addons-path, встановленою на папку з редакцією Enterprise. Для робочої установки Odoo Enterprise необхідно клонувати обидва репозиторії — Community та Enterprise.

Підготовка¶

Python¶

Для роботи Odoo потрібен Python 3.10 або новіша версія.

Змінено в версії 17: Мінімальну вимогу оновлено з Python 3.7 до Python 3.10.

Використовуйте менеджер пакетів для завантаження та встановлення Python 3 за потреби.

Примітка

Якщо Python 3 уже встановлено, переконайтеся, що версія 3.10 або вища, оскільки попередні версії несумісні з Odoo.

$ python3 --version

C:\> python --version

$ python3 --version

Переконайтеся, що для цієї версії також встановлено pip.

$ pip3 --version

C:\> pip --version

$ pip3 --version

PostgreSQL¶

Odoo використовує PostgreSQL як систему керування базами даних.

Змінено в версії 19: Мінімальну вимогу оновлено з PostgreSQL 12 до PostgreSQL 13.

Використовуйте менеджер пакетів для завантаження та встановлення PostgreSQL (підтримувані версії: 13.0 або вище). Це можна зробити, виконавши наступне:

$ sudo apt install postgresql postgresql-client

Використовуйте Postgres.app для завантаження та встановлення PostgreSQL (підтримувана версія: 13.0 або вище).

Порада

Щоб зробити доступними інструменти командного рядка, що входять до складу Postgres.app, налаштуйте змінну $PATH, дотримуючись інструкцій Postgres.app CLI tools.

За замовчуванням єдиним користувачем є postgres. Оскільки Odoo забороняє підключення як postgres, створіть нового користувача PostgreSQL.

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

Примітка

Оскільки користувач PostgreSQL має таке саме ім’я, як логін Unix, можна підключитися до бази даних без пароля.

Додайте каталог bin PostgreSQL (за замовчуванням: C:\Program Files\PostgreSQL\<version>\bin) до PATH.
Створіть користувача postgres з паролем за допомогою графічного інтерфейсу pg admin:
1. Відкрийте pgAdmin.
2. Двічі клацніть на сервері, щоб створити з’єднання.
3. Виберіть Object ‣ Create ‣ Login/Group Role.
4. Введіть ім’я користувача в полі Role Name (наприклад, odoo).
5. Відкрийте вкладку Definition, введіть пароль (наприклад, odoo) і натисніть Save.
6. Відкрийте вкладку Privileges і перемкніть Can login? на Yes і Create database? на Yes.

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

Примітка

Оскільки користувач PostgreSQL має таке саме ім’я, як логін Unix, можна підключитися до бази даних без пароля.

Примітка

Якщо ви хочете використовувати функції штучного інтелекту Odoo, потрібне розширення PostgreSQL pg-vector.

Зауважте, що pg-vector доступний лише для PostgreSQL версії 15 і вище.

Перейдіть до тимчасової папки
```
$ cd /tmp
```
Клонуйте репозиторій GitHub для pg-vector:
```
$ git clone https://github.com/pgvector/pgvector.git
```
Перейдіть до каталогу:
```
$ cd pgvector
```
Скомпілюйте розширення:
```
$ make
```
Встановіть розширення:
```
$ sudo make install
```

Якщо під час встановлення виникнуть проблеми, обов’язково перегляньте офіційні примітки щодо встановлення.

Перейдіть до тимчасової папки
```
$ cd /tmp
```
Клонуйте репозиторій GitHub для pg-vector:
```
$ git clone https://github.com/pgvector/pgvector.git
```
Перейдіть до каталогу:
```
$ cd pgvector
```
Скомпілюйте розширення:
```
$ make
```
Встановіть розширення:
```
$ sudo make install
```

Якщо під час встановлення виникнуть проблеми, обов’язково перегляньте офіційні примітки щодо встановлення.

Перейдіть до тимчасової папки
```
$ cd %TEMP%
```
Клонуйте репозиторій GitHub для pg-vector:
```
$ git clone https://github.com/pgvector/pgvector.git
```
Перейдіть до каталогу:
```
$ cd pgvector
```
Переконайтеся, що підтримку C++ у Visual Studio встановлено, і запустіть x64 Native Tools Command Prompt for VS [version] від імені адміністратора.

Встановіть змінну середовища PGROOT:

$ set "PGROOT=C:\Program Files\PostgreSQL\[Your PostgreSQL Version]"

Скомпілюйте розширення:
```
$ nmake /F Makefile.win
```
Встановіть розширення:
```
$ nmake /F Makefile.win install
```

Якщо під час встановлення виникнуть проблеми, обов’язково перегляньте офіційні примітки щодо встановлення.

Залежності¶

Використання пакетів дистрибутива є найкращим способом встановлення залежностей. Як альтернативу, встановіть залежності Python за допомогою pip.

На Debian/Ubuntu наступні команди мають встановити необхідні пакети:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

Скрипт setup/debinstall.sh проаналізує файл debian/control і встановить знайдені пакети.

Попередження

Використання pip може призвести до проблем безпеки та порушення залежностей; робіть це, лише якщо розумієте, що робите.

Оскільки деякі пакети Python потребують етапу компіляції, вони вимагають встановлення системних бібліотек.

На Debian/Ubuntu наступна команда має встановити ці необхідні бібліотеки:

$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

Залежності Odoo перераховані у файлі requirements.txt, розташованому в кореневій директорії Odoo Community.

Примітка

Пакети Python у requirements.txt базуються на їхніх стабільних/LTS версіях Debian/Ubuntu на момент випуску Odoo. Наприклад, для Odoo 15.0 версія пакета python3-babel становить 2.8.0 у Debian Bullseye та 2.6.0 у Ubuntu Focal. Нижча версія обирається у requirements.txt.

Порада

Краще не змішувати пакети модулів Python між різними екземплярами Odoo або із системою. Однак можна використовувати virtualenv для створення ізольованих середовищ Python.

Перейдіть до шляху встановлення Odoo Community (CommunityPath) і запустіть pip на файлі requirements для встановлення залежностей для поточного користувача.

$ cd /CommunityPath
$ pip install -r requirements.txt

Перед встановленням залежностей завантажте та встановіть Build Tools for Visual Studio. Виберіть C++ build tools на вкладці Workloads і встановіть їх за запитом.

Залежності Odoo перелічені у файлі requirements.txt, розташованому в кореневій теці каталогу Odoo Community.

Порада
Краще не змішувати пакети модулів Python між різними екземплярами Odoo або із системою. Однак можна використовувати virtualenv для створення ізольованих середовищ Python.

Перейдіть до шляху встановлення Odoo Community (CommunityPath) і запустіть pip на файлі requirements у терміналі з правами адміністратора:

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

Залежності Odoo перелічені у файлі requirements.txt, розташованому в кореневій теці каталогу Odoo Community.

Порада
Краще не змішувати пакети модулів Python між різними екземплярами Odoo або із системою. Однак можна використовувати virtualenv для створення ізольованих середовищ Python.

Перейдіть до шляху встановлення Odoo Community (CommunityPath) і запустіть pip на файлі requirements:

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

Попередження

Залежності, що не є Python, повинні бути встановлені за допомогою менеджера пакетів (Homebrew, MacPorts).

Завантажте та встановіть Command Line Tools:
```
$ xcode-select --install
```
Використовуйте менеджер пакетів для встановлення залежностей, що не є Python.

Примітка

Для мов, які використовують інтерфейс справа наліво (наприклад, арабська або іврит), потрібен пакет rtlcss.

Завантажте та встановіть nodejs і npm за допомогою менеджера пакетів.
Встановіть rtlcss:
```
$ sudo npm install -g rtlcss
```

Завантажте та встановіть nodejs.
Встановіть rtlcss:
```
C:\> npm install -g rtlcss
```
Відредагуйте системну змінну середовища PATH, щоб додати теку, де розташовано rtlcss.cmd (зазвичай: C:\Users\<user>\AppData\Roaming\npm\).

Завантажте та встановіть nodejs за допомогою менеджера пакетів (Homebrew, MacPorts).
Встановіть rtlcss:
```
$ sudo npm install -g rtlcss
```

Попередження

wkhtmltopdf не встановлюється через pip і має бути встановлений вручну у версії 0.12.6, щоб підтримувати колонтитули. Перегляньте wiki wkhtmltopdf для отримання детальнішої інформації про різні версії.

Запуск Odoo¶

Після налаштування всіх залежностей Odoo можна запустити, виконавши odoo-bin, інтерфейс командного рядка сервера. Він розташований у кореневій теці каталогу Odoo Community.

Для налаштування сервера вкажіть аргументи командного рядка або конфігураційний файл.

Порада

Для редакції Enterprise додайте шлях до доповнень enterprise до аргументу addons-path. Зверніть увагу, що він повинен передувати іншим шляхам у addons-path, щоб доповнення завантажувалися правильно.

Загальні необхідні конфігурації:

Користувач і пароль PostgreSQL.
Користувацькі шляхи до додатків понад стандартні для завантаження власних модулів.

Типовий спосіб запуску сервера:

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

Де CommunityPath — це шлях до інсталяції Odoo Community, а mydb — ім’я бази даних PostgreSQL.

C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb

Де CommunityPath — це шлях до інсталяції Odoo Community, dbuser — логін PostgreSQL, dbpassword — пароль PostgreSQL, а mydb — ім’я бази даних PostgreSQL.

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

Де CommunityPath — це шлях до інсталяції Odoo Community, а mydb — ім’я бази даних PostgreSQL.

Після запуску сервера (з’явиться INFO-лог odoo.modules.loading: Modules loaded.), відкрийте http://localhost:8069 у веб-браузері та увійдіть до бази даних Odoo з базовим обліковим записом адміністратора: використовуйте admin як електронну пошту та, знову ж таки, admin як пароль.

Порада

Звідти створюйте нових користувачів та керуйте ними.
Обліковий запис користувача для входу до веб-інтерфейсу Odoo відрізняється від аргументу CLI --db_user.

Див. також

Список аргументів CLI для odoo-bin