There are multiple ways to install Odoo, or not install it at all, depending on the intended use case.
В этом документе рассматривается большинство параметров установки.
- Online
Это самый простой способ использовать Odoo. Лучше всего подходит для первого ознакомления с системой
- С помощью инсталлятора
Подходит для тестирования Odoo, разработки модулей и может использоваться для долгосрочного использования при необходимости выполнения дополнительных работ по обслуживанию.
- Из исходников
Обеспечивает большую гибкость: например, можно запустить несколько версий Odoo в одной системе. Хорошо подходит и для разработки модулей, и для продакшн.
- Docker
Если вы обычно используете docker для разработки или развертывания, доступен официальный образ docker.
Версии Odoo
Существуют две версии Editions Odoo: Community и Enterprise. Использование версии Enterprise возможно на нашей SaaS, исходный код доступен корпоративным клиентам и партнерам. Версия Community доступна всем.
Если вы уже используете версию Community и хотите перейти на Enterprise, обратитесь к От Community к Enterprise (кроме Из исходников).
Online
Демонстрационная
Чтобы просто получить краткое представление об Odoo, доступны экземпляры demo. Они представляют собой установки, которые живут в течение нескольких часов, и могут использоваться без каких-либо обязательств.
Для экземпляров Demo не требуется локальная установка, а только веб-браузер.
SaaS
Самый простой способ начать, полностью управляемый и перенесенный с помощью Odoo S.A.,Odoo SaaS предоставляет частный доступ и запускается бесплатно. Его можно использовать для тестирования Odoo и выполнения настроек без кода, без необходимости устанавливать Odoo локально.
Может использоваться как для тестирования Odoo, так и для долгосрочного использования.
Как и экземпляры demo, экземпляры SaaS не требуют локальной установки, достаточно веб-браузера.
С помощью инсталлятора
Odoo предоставляет упакованные инсталляторы для Windows, deb-дистрибутивы (Debian, Ubuntu, ...) и RPM-дистрибутивы (Fedora, CentOS, RHEL, ...) для версий Community и Enterprise.
Эти пакеты автоматически настраивают все зависимости, но могут возникнуть сложности при обновлении.
Официальные пакеты Community со всеми зависимостями доступны на нашем nightly сервере. Пакеты Communtiy и Enterprise можно загрузить с нашей страницы Download (вы должны войти в систему как клиент или партнер для загрузки пакетов Enterprise).
Windows
Загрузите установщик с нашего nightly server (только для Community) или установщика Windows со страницы Download (любая версия)
Запустите загруженный файл
Предупреждение
в Windows 8 вы можете увидеть предупреждение под названием «Windows protected your PC». Нажмите More Info затем Run anyway
Согласиться на предупреждение UAC
Пройдите все этапы установки
Odoo будет автоматически запущен в конце установки.
Linux
Debian/Ubuntu
Odoo 11.0 'deb' пакет на данный момент поддерживает Debian Stretch, Ubuntu Xenial, Ubuntu Zesty и Ubuntu Artful.
Подготовка
Для нормальной работы Odoo нужен сервер PostgreSQL . В конфигурации по умолчанию для 'deb' пакета Odoo настроено использование сервера на том же сервере где запускается экземпляр Odoo. Выполните следующую команду с правами пользователя root для того чтобы установить PostgreSQL сервер :
# apt-get install postgresql -y
Для печати отчетов в формате PDF вы должны установить wkhtmltopdf самостоятельно: версия wkhtmltopdf, доступная в репозиториях debian, не поддерживает верхние и нижние колонтитулы, поэтому она не может быть установлена автоматически. Рекомендуемая версия - 0.12.1 и доступна на the wkhtmltopdf download page в разделе архива. Поскольку официального релиза для Debian Jessie нет, вы можете найти его по ссылке http://nightly.odoo.com/extra/.
Репозиторий
Odoo S.A. предоставляет репозиторий, который может быть использован при установке на Debian и Ubuntu дистрибутивы. Он может быть использован для установки Odoo Community Edition следующим образом:
# wget -O - https://nightly.odoo.com/odoo.key | apt-key add -
# echo "deb http://nightly.odoo.com/11.0/nightly/deb/ ./" >> /etc/apt/sources.list.d/odoo.list
# apt-get update && apt-get install odoo
Затем вы можете использовать обычную команду apt-get upgrade
для обновления вашей установки.
На данный момент не существует репозитория для Enterprise Edition
Deb пакеты
Если вы не хотите использовать репозиторий, как описано выше, то 'deb' пакет можно скачать здесь:
Вы можете использовать команду gdebi
:
# gdebi <path_to_installation_package>
Или dpkg
(обрабатывает меньше зависимостей автоматически):
# dpkg -i <path_to_installation_package> # this probably fails with missing dependencies
# apt-get install -f # should install the missing dependencies
# dpkg -i <path_to_installation_package>
Это установит Odoo в качестве службы, создаст нужного пользователя PostgreSQL и автоматически запустит сервер.
Предупреждение
3 следующих пакета python предлагаются только пакетом Debian. Эти пакеты недоступны в Ubuntu Xenial (16.04).
python3-vobject: Используется в календарях для создания ical файлов.
python3-pyldap: используется для аутентификации пользователей с помощью LDAP.
python3-qrcode: используется аппаратным драйвером для ESC/POS
Если вам нужен один или все пакеты, упомянутые в приведенном выше предупреждении, вы можете установить их вручную. Один из способов сделать это - просто использовать pip3 следующим образом:
$ sudo pip3 install vobject qrcode
$ sudo apt install libldap2-dev libsasl2-dev
$ sudo pip3 install pyldap
Предупреждение
Debian 9 и Ubuntu не предоставляют пакет для Python модуля num2words. Odoo не сможет сформировать сумму прописью и это может вызвать проблемы с модулем "l10n_mx_edi".
Если вам необходим данный функционал, вы можете установить модуль способом указанным ниже:
$ sudo pip3 install num2words
Fedora
Для Odoo 11.0 пакеты 'rpm' поддерживаются для Fedora 26. Начиная с 2017 года рекомендуется использовать Fedora 26. CentOS не удовлетворяет минимальным требованиям Python (3.5) для Odoo 11.0.
Подготовка
Для нормальной работы Odoo нужен PostgreSQL -сервер . Предполагая, что команда 'sudo' доступна и настроена правильно, выполните следующие команды :
$ sudo dnf install -y postgresql-server
$ sudo postgresql-setup --initdb --unit postgresql
$ sudo systemctl enable postgresql
$ sudo systemctl start postgresql
Для печати отчетов в формате PDF вы должны установить wkhtmltopdf самостоятельно: версия wkhtmltopdf, доступная в репозиториях debian, не поддерживает верхние и нижние колонтитулы, поэтому она не может быть установлена автоматически. Рекомендуемая версия - 0.12.1 и доступна на the wkhtmltopdf download page в разделе архива. Поскольку официального релиза для Debian Jessie нет, вы можете найти его по ссылке http://nightly.odoo.com/extra/.
Репозиторий
Odoo S.A. предоставляет репозиторий для использования в дистрибутивах Fedora. Он может быть задействован для установки Odoo Community Edition, выполнив следующие команды:
$ sudo dnf config-manager --add-repo=https://nightly.odoo.com/11.0/nightly/rpm/odoo.repo
$ sudo dnf install -y odoo
$ sudo systemctl enable odoo
$ sudo systemctl start odoo
RPM пакеты
Если вы не хотите использовать по каким либо причинам выше описанный репозиторий, то можете просто скачать 'rpm' пакет здесь:
После загрузки, пакет может быть установлен с помощью пакетного менеджера dnf
:
$ sudo dnf localinstall odoo_11.0.latest.noarch.rpm
$ sudo systemctl enable odoo
$ sudo systemctl start odoo
Из исходников
"Установка" из исходников на самом деле заключается в том, чтобы не устанавливать Odoo и запускать ее непосредственно из источника.
Это может быть более удобным для разработчиков модулей, поскольку исходники Odoo будут расположены так, как вам нужно. Это может быть удобнее чем использование пакетной установки (для изучения исходного кода модулей или для сборки этой документации и ее доступности в автономном режиме).
запуск и остановка работы Odoo становятся более гибким и очевидными, чем службы, настроенные упакованными установками, и позволяет переопределять параметры, используя параметры командной строки без необходимости редактировать файл конфигурации.
Наконец, он обеспечивает больший контроль над настройкой системы и позволяет более легко поддерживать (и запускать) несколько версий Odoo на одном компьютере.
Подготовка
Для установки из исходников нужно вручную установить все зависимости:
Python 3.5+.
на Linux и OS X, используя ваш менеджер пакетов, если он не установлен по умолчанию
Примечание
на некоторой системе команда
python
ссылается на Python 2 (устаревший) или на Python 3 (поддерживается). Убедитесь, что вы используете правильную версию и что псевдонимpython3
присутствует в вашемPATH
в Windows, используйте официальный установщик Python 3.
Предупреждение
выберите «добавить python.exe в Path» во время установки и затем перезагрузитесь, для обновления
PATH
.Примечание
если Python уже установлен, убедитесь, что его версия равна 3.5 или выше, предыдущие версии не совместимы с Odoo.
PostgreSQL, чтобы использовать локальную базу данных
После установки вам нужно будет создать пользователя postgres: по умолчанию единственным пользователем является
postgres
, а Odoo запрещает подключение от имениpostgres
.на Linux, используйте пакет дистрибутива, а затем создайте пользователя postgres, с именем как ваш логин:
$ sudo su - postgres -c "createuser -s $USER"
Поскольку учетная запись роли совпадает с вашим unix-пользователем, его можно использовать без пароля.
на OS X, postgres.app - это самый простой способ начать работу, а затем создать пользователя postgres, как на Linux
в Windows, используйте PostgreSQL for windows, затем
добавьте каталог
bin
PostgreSQL (по умолчанию:C:\Program Files\PostgreSQL\9.4\ bin
) вPATH
создайте пользователя postgres с паролем, используя pg admin gui: откройте pgAdminIII, дважды щелкните сервер, чтобы создать соединение, выберите Role Name (например,
, введите имя пользователя вodoo
), затем откройте вкладку Definition и введите пароль (например,`odoo`
), затем нажмите OK.Пользователь и пароль должны быть переданы в Odoo с помощью опций
-w
и-r
или файла конфигурации
Python зависимости перечислены в файле
requirements.txt
.в Linux зависимости python могут быть установлены с помощью менеджера пакетов системы или с помощью pip.
Для библиотек, использующих собственный код (Pillow, lxml, greenlet, gevent, psycopg2, ldap), может потребоваться установить инструменты разработки и собственные зависимости до того, как pip сможет самостоятельно установить их. Они доступны в пакетах
-dev
или-devel
для Python, Postgres, libxml2, libxslt, libevent, libsasl2 и libldap2. После их установки сами зависимости Python могут быть установлены:$ pip3 install -r requirements.txt
на OS X вам нужно будет установить средства командной строки (
xcode-select --install
), а затем загрузить и установить менеджер пакетов по вашему выбору (homebrew, macports) для установки зависимостей, отличных от Python. pip можно затем использовать для установки зависимостей Python, как на Linux:$ pip3 install -r requirements.txt
на Windows вам нужно установить некоторые из зависимостей вручную, настроить файл requirements.txt, а затем запустить pip для установки исправлений.
Установите
psycopg
с помощью установщика здесь http://www.stickpeople.com/projects/python/win-psycopg/Затем используйте pip для установки зависимостей, используя следующую команду из приглашения cmd.exe (замените
\YourOdooPath
на путь, куда вы загрузили Odoo):C:\> cd \YourOdooPath C:\YourOdooPath> C:\Python35\Scripts\pip.exe install -r requirements.txt
Less CSS nodejs
в Linux используйте менеджер пакетов вашего дистрибутива для установки nodejs и npm.
Предупреждение
В debian wheezy и Ubuntu 13.10 nodejs нужно установить вручную:
$ wget -qO- https://deb.nodesource.com/setup | bash - $ apt-get install -y nodejs
В более поздних debian (> jessie) и ubuntu (> 14.04) вам может понадобиться добавить символическую ссылку, поскольку пакеты npm вызывают
node
, а debian вызываетnodejs
$ apt-get install -y npm $ sudo ln -s /usr/bin/nodejs /usr/bin/node
После установки npm, установите less
$ sudo npm install -g less
на OS X, установите nodejs через ваш предпочтительный менеджер пакетов (homebrew, macports), а затем установите less:
$ sudo npm install -g less
on Windows, install nodejs, reboot (to update the
PATH
) and install less:C:\> npm install -g less
Установка из исходников
Есть два способа получить исходные тексты Odoo: zip-архив или git.
Odoo zip можно загрузить с нашего nightly сервера или на странице Download, Для использования распакуйте архив.
git позволяет упростить обновление и упростить переключение между различными версиями Odoo. Это также упрощает сохранение патчей и внесение вкладов в разработку Odoo. Основной недостаток git заключается в том, что он значительно больше, чем zip-архив, поскольку он содержит всю историю проекта Odoo.
Community Edition
Git репозиторий для версии Community доступен по ссылке https://github.com/odoo/odoo.git.
Для его загрузки необходим git client (который может быть доступен в репозиториях вашего дистрибутива в Linux) и может выполняться с помощью следующей команды:
$ git clone https://github.com/odoo/odoo.git
Enterprise Edition
Если у вас есть доступ к репозиторию Enterprise (см. Версии Odoo, если вы хотите получить доступ), вы можете использовать эту команду для клонирования исходников:
$ git clone https://github.com/odoo/enterprise.git
Примечание
Git-репозиторий Enterprise не содержит полный исходный код Odoo. Это всего лишь набор дополнительных модулей. Основной код находиться в версии Community. Запуск версии Enterprise фактически означает запуск Odoo Community с опцией addons-path, в которой прописана папка с установленными модулями версии Enterprise.
Вам нужно клонировать как Community репозиторий , так и Enterprise, чтобы получить рабочую установку Odoo. Страница Download содержит весь исходный код, но его не так легко обновлять.
Запуск Odoo
Как только все зависимости будут установлены, Odoo можно запустить, запустив odoo-bin
.
Совет
Для версии Enterprise вы должны указать папку модулей enterprise
при запуске вашего сервера. Вы можете сделать это, указав путь к вашей папке с модулями enterprise
в параметре addons-path
. Обратите внимание, что папка enterprise
должна находиться перед объявлением папки с модулями по умолчанию addons
в списке для правильной загрузки модулей.
Конфигурация может быть предоставлена или через аргументы командной строки или через файл конфигурации.
Общие необходимые настройки:
PostgreSQL - хост, порт, пользователь и пароль .
У Odoo нет значений psycopg2 по умолчанию: подключение через UNIX сокет на порт 5432 с именем текущего пользователем без пароля. По умолчанию это должно работать на Linux и OS X, но оно не будет работать в Windows, так как в ней нет поддержки UNIX-сокетов.
Путь к папке, в которой хранятся ваши модули.
В Windows типичный способ запуска odoo:
C:\YourOdooPath> python3 odoo-bin -w odoo -r odoo --addons-path=addons,../mymodules --db-filter=mydb$
Где odoo
, odoo
- это логин и пароль postgresql, ../ mymodules
- каталог с пользовательскими модулями и mydb
- база данных для localhost:8069
В Unix типичный способ запуска Odoo:
$ ./odoo-bin --addons-path=addons,../mymodules --db-filter=mydb$
Где ../mymodules
- это каталог с пользовательскими модулями и mydb
база данных для localhost:8069
Virtualenv - виртуальное окружение для Python
Virtualenv является инструментом для создания изолированных окружений Python, т.к. возникают случае когда есть необходимость не смешивать глобально установленные модули Python через пакетный менеджер вашей системы с установленным глобально Python модулями через пакетный менеджер PIP.
В этом разделе описывается, как запустить Odoo в такой изолированной среде Python.
Здесь мы собираемся использовать механизм virtualenvwrapper, который представляет собой набор скриптов, что делает использование виртуального окружения проще .
Приведенные ниже примеры основаны на дистрибутиве Debian 9, но может быть адаптирована на любой платформе, где есть virtualenvwrapper и virtualenv.
В этом разделе предполагается, что вы получили исходные тексты Odoo в виде zip-архива или git-репозитория, как описано выше. Это же относится и к установке PostgreSQL и его конфигурации.
Установка virtualenvwrapper
$ sudo apt install virtualenvwrapper
$ source /usr/share/virtualenvwrapper/virtualenvwrapper.sh
Это позволит установить virtualenvwrapper и сразу активировать его. Теперь, давайте установим инструменты, необходимых для построения зависимости Odoo если это нам необходимо:
$ sudo apt install build-essential python3-dev libxslt-dev libzip-dev libldap2-dev libsasl2-dev
Создайте изолированное окружение
Теперь мы может создать виртуальное окружение для Odoo:
$ mkvirtualenv -p /usr/bin/python3 odoo-venv
С помощью этой команды, мы создаем изолированную среду для Python3, которая будет называться "odoo-env". Если команда сработает как нужно, то ваша оболочка теперь, использует эту среду. Ваше приглашение должно быть изменено, чтобы напомнить вам, что вы используете изолированную среду. Вы можете проверить это с помощью этой команды:
$ which python3
Эта команда должна показать вам путь к Python интерпретатору, который находится в изолированном каталоге среде.
Теперь давайте установим требуемые Odoo пакеты для Python:
$ cd your_odoo_sources_path
$ pip install -r requirements.txt
Через некоторое время, все должны быть готово для запуска Odoo из командной строки, как описано выше.
Когда вы вы хотите выйти из виртуальной среды, просто выполните эту команду:
$ deactivate
Каждый раз, когда вы захотите поработать с окружением 'odoo-venv':
$ workon odoo-venv
Docker
The full documentation on how to use Odoo with Docker can be found on the official Odoo docker image page.