Встановлення з вихідного коду¶
„Встановлення“ вихідного коду стосується не встановлення Odoo, а його запуску безпосередньо з вихідного коду.
Використання джерела Odoo може бути зручнішим для розробників модулів, оскільки воно легше доступне, ніж використання упакованих інсталяторів.
Це робить запуск і зупинку Odoo більш гнучким і зрозумілим, ніж служби, налаштовані пакетними інсталяторами. Крім того, це дозволяє змінювати налаштування за допомогою параметрів командного рядка без необхідності редагувати файл конфігурації.
Нарешті, це забезпечує більший контроль над налаштуваннями системи та дозволяє легше підтримувати (і запускати) кілька версій Odoo поруч.
Отримати джерела¶
Є два способи отримати вихідний код Odoo: як архів ZIP або через Git.
Архів¶
Версія Community:
Версія Enterprise:
Git¶
Примітка
Необхідно встановити Git, і для продовження рекомендується мати базові знання про команди Git.
Щоб клонувати сховище Git, виберіть клонування за допомогою HTTPS або SSH. У більшості випадків найкращим варіантом є HTTPS. Однак виберіть SSH, щоб додати вихідний код Odoo або дотримуючись підручник для розробників із початку роботи.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Примітка
Репозиторій Enterprise git не містить повного вихідного коду Odoo. Це лише набір додаткових додатків. Код основного сервера знаходиться у версії Community. Запуск версії Enterprise означає запуск сервера з версії Community із параметром addons-path, встановленим для папки з версією Enterprise. Необхідно клонувати репозиторії Community та Enterprise, щоб мати робочу інсталяцію Odoo Enterprise.
Підготовити¶
Python¶
Для роботи Odoo потрібен Python 3.10 або новішої версії.
Змінено в версії 17: Мінімальні вимоги оновлено з Python 3.7 до Python 3.10.
За потреби скористайтеся менеджером пакетів, щоб завантажити та встановити Python 3.
Завантажте останню версію Python 3 та встановіть її.
Під час інсталяції позначте Add Python 3 to PATH, потім натисніть Customize Installation і переконайтеся, що pip позначено.
Примітка
Якщо Python 3 уже встановлено, переконайтеся, що версія 3.10 або новіша, оскільки попередні версії несумісні з Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Переконайтеся, що pip також встановлено для цієї версії.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo використовує PostgreSQL як систему керування базами даних.
Використовуйте менеджер пакетів, щоб завантажити та встановити PostgreSQL (підтримувані версії: 12.0 або вище). Цього можна досягти, виконавши наступне:
$ sudo apt install postgresql postgresql-client
Завантажте PostgreSQL (підтримувані версії: 12.0 або вище) і встановіть його.
Використовуйте Postgres.app, щоб завантажити та встановити PostgreSQL (підтримувана версія: 12.0 або вище).
Порада
Щоб інструменти командного рядка, які входять до складу Postgres.app, були доступними, обов’язково налаштуйте змінну $PATH, дотримуючись інструкцій щодо інструментів Postgres.app CLI tools instructions.
За замовчуванням єдиним користувачем є postgres. Оскільки Odoo забороняє підключатися як postgres, створіть нового користувача PostgreSQL.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Примітка
Оскільки ім’я користувача PostgreSQL збігається з іменем користувача Unix, можна підключитися до бази даних без пароля.
Додайте каталог PostgreSQL
bin(за умовчанням:C:\Program Files\PostgreSQL\<version>\bin) доPATH.Створити користувача postgres із паролем за допомогою інтерфейсу адміністратора pg:
Відкрити pgAdmin.
Двічі клацніть сервер, щоб створити підключення.
Виберіть .
Введіть ім’я користувача в поле Ім’я ролі (наприклад,
odoo).Відкрийте вкладку Визначення, введіть пароль (наприклад,
odoo) і натисніть Зберегти.Відкрийте вкладку Privileges та змініть параметр Can login? на
Такі Create database? наYes.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Примітка
Оскільки ім’я користувача PostgreSQL збігається з іменем користувача Unix, можна підключитися до бази даних без пароля.
Залежності¶
Використання дистрибутивних пакетів є кращим способом встановлення залежностей. Крім того, установіть залежності 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.
Примітка
Пакунки 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 у файлі вимог, щоб установити вимоги для поточного користувача.
$ cd /CommunityPath
$ pip install -r requirements.txt
Перед встановленням залежностей завантажте та інсталюйте Інструменти збірки для Visual Studio. Виберіть Інструменти збірки C++ на вкладці Робочі навантаження та встановіть їх, коли буде запропоновано.
Залежності Odoo перераховані у файлі requirements.txt, розташованому в корені каталогу Odoo Community.
Порада
Бажано не змішувати пакети модулів Python між різними примірниками Odoo або з системою. Однак можна використовувати virtualenv для створення ізольованих середовищ Python.
Перейдіть до шляху встановлення Odoo Community (CommunityPath) і запустіть pip у файлі вимог у терміналі з правами адміністратора:
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 у файлі вимог:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Примітка
Для мов, які використовують інтерфейс справа наліво (наприклад, арабська чи іврит), потрібен пакет 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\) .
Попередження
wkhtmltopdf не встановлюється через pip і має бути встановлено вручну у версії 0.12.6 для нього для підтримки колонтитулів. Перегляньте wkhtmltopdf wiki, щоб дізнатися більше про різні версії.
Запуск 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.
Дивись також