安装 Odoo

有多种方法可以安装Odoo,或者根本不安装它,这取决于预期的用例。

本文档尝试描述大多数安装选项。

:ref:setup/install/online

在生产中使用Odoo或尝试它的最简单方法。

:ref:setup/install/packaged

适用于测试Odoo,开发模块,可用于长期生产使用,并具有额外的部署和维护工作。

:ref:setup/install/source

提供更大的灵活性:例如,允许在同一系统上运行多个Odoo版本。适合开发模块,可作为生产部署的基础。

:ref:setup/install/docker

如果通常使用 docker 进行开发或部署,则可以使用官方docker_基础映像。

版本

Odoo有两种不同的Editions:社区版和企业版。在我们的SaaS_可以使用企业版,并且访问代码仅限于企业客户和合作伙伴。社区版本可供任何人免费使用。

如果您已经使用社区版本并希望升级到企业版,请参阅:ref:setup/enterprise`(除了:ref:`setup/install/source)。

在线

样例

为了快速了解Odoo,可以使用demo_实例。它们是仅存活几个小时的共享实例,可用于浏览和尝试,而无需承诺。

Demo_实例不需要本地安装,只需要一个 Web 浏览器。

SaaS

Odoo的SaaS_从一开始就很简单,由Odoo S.A.完全管理和迁移,提供私有实例,并且从免费开始。它可用于发现和测试Odoo并进行非代码自定义(即与自定义模块或Odoo应用程序商店不兼容),而无需在本地安装。

可用于测试 Odoo 和长期生产用途。

与demo_实例一样,SaaS_实例不需要本地安装,因此 Web 浏览器就足够了。

打包安装程序

Odoo为Windows,基于deb的发行版(Debian,Ubuntu,…)和基于RPM的发行版(Fedora,CentOS,RHEL等)提供打包的安装程序,用于社区和企业版本。

这些包会自动设置所有依赖项(对于社区版本),但可能很难保持最新状态。

包含所有相关依赖项要求的官方社区包可在我们的nightly_服务器上找到。Communtiy 和 Enterprise 软件包都可以从我们的download_页面下载(您必须以付费客户或合作伙伴身份登录才能下载企业版软件包)。

Windows

  1. 从我们的nightly_服务器(仅限社区)下载安装程序,或从download_页面(任何版本)下载 Windows 安装程序。

  2. 执行下载的文件。

    警告

    在 Windows 8 及更高版本上,您可能会看到标题为“Windows 保护您的 PC”的警告。
    单击“ 多信 ”,然后单击“仍然运行”。<
  3. 接受UAC_提示。

  4. 完成各种安装步骤。

Odoo将在安装结束时自动启动。

Linux

Debian/Ubuntu

Odoo 13.0 ‘deb’ package currently supports Debian Buster, Ubuntu 18.04 or above.

准备

Odoo需要一个’PostgreSQL’_服务器才能正常运行。Odoo ‘deb’ 软件包的默认配置是使用与 Odoo 实例相同的主机上的 PostgreSQL 服务器。执行以下命令以安装PostgreSQL服务器:

$ sudo apt install postgresql -y

警告

wkhtmltopdf 不是通过 pip 安装的,必须在版本 `0.12.5 `_ 中手动安装 <the wkhtmltopdf download page>,才能支持页眉和页脚。请参阅我们的“wiki <https: github.com/odoo/odoo/wiki/wkhtmltopdf=””>”_,了解有关各种版本的更多详细信息。</https:></the>

存储库

Odoo S.A.提供了一个可以与 Debian 和 Ubuntu 发行版一起使用的存储库。它可以通过执行以下命令 **为root **用于安装*Odoo社区版*:

# wget -O - https://nightly.odoo.com/odoo.key | apt-key add -
# echo "deb http://nightly.odoo.com/13.0/nightly/deb/ ./" >> /etc/apt/sources.list.d/odoo.list
# apt-get update && apt-get install odoo

然后,您可以使用通常的“apt-get upgrade”命令来使您的安装保持最新状态。

目前,企业版没有夜间存储库。

德布包

无需使用上述存储库,*社区*和*企业*版本的“deb”包都可以从“官方下载页面<download>”_下载。

接下来,以 root 用户身份执行以下命令:

# 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_用户并自动启动服务器。

警告

“python3-xlwt” Debian 软件包在 Debian Buster 和 Ubuntu 18.04 中都不存在。需要此python模块才能导出为xls格式。

如果需要该功能,可以使用以下命令手动安装:

$ sudo pip3 install xlwt

警告

“num2words” python 软件包在 Debian Buster 和 Ubuntu 18.04 中都不存在。Odoo不会呈现文本量,这可能会导致“l10n_mx_edi”模块出现问题。

如果需要此功能,可以使用以下命令手动安装:

$ sudo pip3 install num2words

Fedora

Odoo 13.0 ‘rpm’ package supports Fedora 30.

准备

Odoo需要一个`PostgreSQL`_服务器才能正常运行。确保“sudo”命令可用且配置良好,然后执行以下命令以安装PostgreSQL服务器:

$ sudo dnf install -y postgresql-server
$ sudo postgresql-setup --initdb --unit postgresql
$ sudo systemctl enable postgresql
$ sudo systemctl start postgresql

警告

wkhtmltopdf 不是通过 pip 安装的,必须在版本 `0.12.5 `_ 中手动安装 <the wkhtmltopdf download page>,才能支持页眉和页脚。请参阅我们的“wiki <https: github.com/odoo/odoo/wiki/wkhtmltopdf=””>”_,了解有关各种版本的更多详细信息。</https:></the>

存储库

Odoo S.A.提供了一个可以与 Fedora 发行版一起使用的存储库。它可以通过执行以下命令来安装*Odoo社区版*:

$ sudo dnf config-manager --add-repo=https://nightly.odoo.com/13.0/nightly/rpm/odoo.repo
$ sudo dnf install -y odoo
$ sudo systemctl enable odoo
$ sudo systemctl start odoo
转速包

无需使用上述存储库,*社区*和*企业*版本的“rpm”包都可以从“官方下载页面<download>”_下载。

下载后,可以使用“dnf”包管理器安装包:

$ sudo dnf localinstall odoo_13.0.latest.noarch.rpm
$ sudo systemctl enable odoo
$ sudo systemctl start odoo

源安装

源代码“安装”实际上是关于不安装Odoo,而是直接从源代码运行它。

这对模块开发人员来说可能更方便,因为Odoo源代码比使用打包安装更容易访问(用于提供信息或构建本文档并使其离线可用)。

它还使启动和停止Odoo比打包安装设置的服务更加灵活和明确,并允许使用:ref:`命令行参数<reference/cmdline>`覆盖设置,而无需编辑配置文件。

最后,它提供了对系统设置的更大控制,并允许更轻松地并排保存(和运行)多个版本的Odoo。

Windows

获取源

有两种方法可以获得Odoo的源代码:作为zip archive **通 git**。

存档

(社区版)

(企业版)

Git

以下需要您先安装 Git<git_> 并具有Git命令的基本知识。要克隆Git存储库,您必须选择使用HTTPS或SSH来操作。如果您不知道两者之间的区别,一般优先选择HTTPS。如果您正在关注`Getting started</developer/howtos/rdtraining>` 开发者教程,或计划投稿Odoo源代码,请选择 SSH。

注解

企业 git 存储库不包含完整的 Odoo 源代码 。它只是额外附加组件的集合。主服务器代码位于社区版本中。运行企业版实际上意味着从社区版本运行服务器,并将插件路径选项设置为具有企业版的文件夹。您需要克隆社区和企业存储库才能进行 Odoo 企业版安装。

C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git

准备

Python

Odoo requires Python 3.6 or later to run. Visit Python’s download page to download and install the latest version of Python 3 on your machine.

在安装过程中,选中“ ** Python 3 添加到 PATH**”,然后单击“ 定义安 ”并确保选中“pip”。

注解

If Python 3 is already installed, make sure that the version is 3.6 or above, as previous versions are not compatible with Odoo.

C:\> python --version

还要验证是否为此版本安装了pip

C:\> pip --version
PostgreSQL

Odoo使用PostgreSQL作为数据库管理系统。“下载并安装 PostgreSQL <https://www.postgresql.org/download/windows/>”_(支持的版本:10.0 及更高版本)。

默认情况下,唯一的用户是`postgres`,但Odoo禁止以`postgres`的身份连接,所以你需要创建一个新的PostgreSQL用户:

  1. 将PostgreSQL的“bin”目录(默认情况下:“C:\Program Files\PostgreSQL\<version>\bin”)添加到您的“PATH”中。</version>

  2. 使用 pg admin gui 创建一个具有密码的 postgres 用户:

    1. 打开 pgAdmin

    2. 双击服务器以创建连接。

    3. 选择:menuselection:对象 --> 创建 --> 登录名/组角色

    4. 在“角色名称”字段中输入用户名(例如“odoo”)。

    5. 打开“ **** ”选项卡并输入密码(例如“odoo”),然后单击“保存”。“。”odoo“(”odoo“)

    6. 打开“权限”选项卡,将“可以登录?”切换为“是”,将“创建数据库?”切换为“是”。

相关性

在安装依赖项之前,必须下载并安装“Visual Studio <https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019>的生成工具”。</a)出现提示时,在“工作负载”选项卡中选择“C++生成工** ”并进行安装。

Odoo依赖项列在位于Odoo社区目录根目录的“需求.txt”文件中。

小技巧

最好不要在Odoo的不同实例之间或与您的系统混合使用python模块包。您可以使用virtualenv_来创建隔离的 Python 环境。

导航到 Odoo 社区安装的路径(“CommunityPath”),并在终端中对需求文件运行 pip,使用管理员权** :

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

警告

wkhtmltopdf 不是通过 pip 安装的,必须在版本 `0.12.5 `_ 中手动安装 <the wkhtmltopdf download page>,才能支持页眉和页脚。请参阅我们的“wiki <https: github.com/odoo/odoo/wiki/wkhtmltopdf=””>”_,了解有关各种版本的更多详细信息。</https:></the>

对于具有从右到左界面的语言(例如阿拉伯语或希伯来语),需要包“rtlcss”:

  1. 下载并安装 nodejs

  2. 安装 rtlcss

    C:\> npm install -g rtlcss
    
  3. 编辑系统环境的变量“PATH”以添加“rtlcss.cmd”所在的文件夹(通常为:“C:\Users\<user>\AppData\Roaming\npm\”)。</user>

运行 Odoo

一旦设置了所有依赖项,就可以通过运行服务器的命令行界面“odoo-bin”来启动Odoo。它位于Odoo社区目录的根目录。

要配置服务器,您可以指定 :ref:命令行参数<reference/cmdline/server> 或 :ref:配置文件 <reference/cmdline/config>

小技巧

对于企业版,必须将“企业”插件的路径添加到“插件路径”参数中。请注意,它必须位于“插件路径”中的其他路径之前,才能正确加载插件。

常见的必要配置有:

  • PostgreSQL 用户和密码。

  • 超出默认值的自定义插件路径,以加载您自己的模块。

运行服务器的典型方法是:

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

Where CommunityPath is the path of the Odoo Community installation, dbuser is the PostgreSQL login, dbpassword is the PostgreSQL password and mydb is the name of the PostgreSQL database.

After the server has started (the INFO log odoo.modules.loading: Modules loaded. is printed), open http://localhost:8069 in your web browser and log in with the base administrator account: Use admin for the Email and, again, admin for the Password. That’s it, you just logged into your own Odoo database!

小技巧

  • From there, you can create and manage new users.

  • The user account you use to log into Odoo’s web interface differs from the --db_user CLI argument.

Linux

获取源

有两种方法可以获得Odoo的源代码:作为zip archive **通 git**。

存档

(社区版)

(企业版)

Git

以下需要您先安装 Git<git_> 并具有Git命令的基本知识。要克隆Git存储库,您必须选择使用HTTPS或SSH来操作。如果您不知道两者之间的区别,一般优先选择HTTPS。如果您正在关注`Getting started</developer/howtos/rdtraining>` 开发者教程,或计划投稿Odoo源代码,请选择 SSH。

注解

企业 git 存储库不包含完整的 Odoo 源代码 。它只是额外附加组件的集合。主服务器代码位于社区版本中。运行企业版实际上意味着从社区版本运行服务器,并将插件路径选项设置为具有企业版的文件夹。您需要克隆社区和企业存储库才能进行 Odoo 企业版安装。

$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git

准备

Python

Odoo requires Python 3.6 or later to run. Use your package manager to download and install Python 3 on your machine if it is not already done.

注解

If Python 3 is already installed, make sure that the version is 3.6 or above, as previous versions are not compatible with Odoo.

$ python3 --version

还要验证是否为此版本安装了pip

$ pip3 --version
PostgreSQL

Odoo使用PostgreSQL作为数据库管理系统。使用包管理器下载并安装 PostgreSQL(支持的版本:10.0 及更高版本)。

在 Debian/Unbuntu 上,可以通过执行以下命令来实现:

$ sudo apt install postgresql postgresql-client

默认情况下,唯一的用户是`postgres`,但Odoo禁止以`postgres`的身份连接,所以你需要创建一个新的PostgreSQL用户:

$ sudo -u postgres createuser -s $USER
$ createdb $USER

注解

由于您的PostgreSQL用户与您的Unix登录名同名,因此您将能够在没有密码的情况下连接到数据库。

相关性

对于使用原生代码的库,有必要在Odoo的Python依赖之前安装开发工具和原生依赖项。它们可用于Python,PostgreSQL,libxml2,libxslt1,libevent,libsasl2和libldap2的`-dev`或`-devel`包。

在 Debian/Unbuntu 上,以下命令应该安装所有必需的库:

$ sudo apt install python3-dev libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev \
    libtiff5-dev libjpeg8-dev libopenjp2-7-dev zlib1g-dev libfreetype6-dev \
    liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev libpq-dev

Odoo依赖项列在位于Odoo社区目录根目录的“需求.txt”文件中。

小技巧

最好不要在Odoo的不同实例之间或与您的系统混合使用python模块包。您可以使用virtualenv_来创建隔离的 Python 环境。

导航到 Odoo 社区安装的路径(“CommunityPath”),并在需求文件上运行 pip

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

警告

wkhtmltopdf 不是通过 pip 安装的,必须在版本 `0.12.5 `_ 中手动安装 <the wkhtmltopdf download page>,才能支持页眉和页脚。请参阅我们的“wiki <https: github.com/odoo/odoo/wiki/wkhtmltopdf=””>”_,了解有关各种版本的更多详细信息。</https:></the>

对于具有从右到左界面的语言(例如阿拉伯语或希伯来语),需要包“rtlcss”:

  1. 使用包管理器下载并安装 nodejsnpm

  2. 安装 rtlcss

    $ sudo npm install -g rtlcss
    

运行 Odoo

一旦设置了所有依赖项,就可以通过运行服务器的命令行界面“odoo-bin”来启动Odoo。它位于Odoo社区目录的根目录。

要配置服务器,您可以指定 :ref:命令行参数<reference/cmdline/server> 或 :ref:配置文件 <reference/cmdline/config>

小技巧

对于企业版,必须将“企业”插件的路径添加到“插件路径”参数中。请注意,它必须位于“插件路径”中的其他路径之前,才能正确加载插件。

常见的必要配置有:

  • PostgreSQL 用户和密码。Odoo除了“psycopg2的默认值<http://initd.org/psycopg/docs/module.html>”_之外没有默认值:通过端口“5432”上的UNIX套接字与当前用户连接,没有密码。

  • 超出默认值的自定义插件路径,以加载您自己的模块。

运行服务器的典型方法是:

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

Where CommunityPath is the path of the Odoo Community installation and mydb is the name of the PostgreSQL database.

After the server has started (the INFO log odoo.modules.loading: Modules loaded. is printed), open http://localhost:8069 in your web browser and log in with the base administrator account: Use admin for the Email and, again, admin for the Password. That’s it, you just logged into your own Odoo database!

小技巧

  • From there, you can create and manage new users.

  • The user account you use to log into Odoo’s web interface differs from the --db_user CLI argument.

Mac OS

获取源

有两种方法可以获得Odoo的源代码:作为zip archive **通 git**。

存档

(社区版)

(企业版)

Git

以下需要您先安装 Git<git_> 并具有Git命令的基本知识。要克隆Git存储库,您必须选择使用HTTPS或SSH来操作。如果您不知道两者之间的区别,一般优先选择HTTPS。如果您正在关注`Getting started</developer/howtos/rdtraining>` 开发者教程,或计划投稿Odoo源代码,请选择 SSH。

注解

企业 git 存储库不包含完整的 Odoo 源代码 。它只是额外附加组件的集合。主服务器代码位于社区版本中。运行企业版实际上意味着从社区版本运行服务器,并将插件路径选项设置为具有企业版的文件夹。您需要克隆社区和企业存储库才能进行 Odoo 企业版安装。

$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git

准备

Python

Odoo requires Python 3.6 or later to run. Use your preferred package manager (homebrew, macports) to download and install Python 3 on your machine if it is not already done.

注解

If Python 3 is already installed, make sure that the version is 3.6 or above, as previous versions are not compatible with Odoo.

$ python3 --version

还要验证是否为此版本安装了pip

$ pip3 --version
PostgreSQL

Odoo使用PostgreSQL作为数据库管理系统。使用`postgres.app <https://postgresapp.com>`_下载并安装PostgreSQL(支持的版本:10.0及更高版本)。

小技巧

要使与 postgres.app 捆绑在一起的命令行工具可用,请确保按照 Postgres.app CLI工具说明 <https://postgresapp.com/documentation/cli-tools.html>`_设置您的 `$PATH 变量。

默认情况下,唯一的用户是`postgres`,但Odoo禁止以`postgres`的身份连接,所以你需要创建一个新的PostgreSQL用户:

$ sudo -u postgres createuser -s $USER
$ createdb $USER

注解

由于您的PostgreSQL用户与您的Unix登录名同名,因此您将能够在没有密码的情况下连接到数据库。

相关性

Odoo依赖项列在位于Odoo社区目录根目录的“需求.txt”文件中。

小技巧

最好不要在Odoo的不同实例之间或与您的系统混合使用python模块包。您可以使用virtualenv_来创建隔离的 Python 环境。

导航到 Odoo 社区安装的路径(“CommunityPath”),并在需求文件上运行 pip

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

警告

非Python依赖项需要与包管理器一起安装:

  1. 下载并安装命令行工** :

    $ xcode-select --install
    
  2. 下载并安装您选择的软件包管理器(homebrewmacports)。

  3. 安装非 python 依赖项。

警告

wkhtmltopdf 不是通过 pip 安装的,必须在版本 `0.12.5 `_ 中手动安装 <the wkhtmltopdf download page>,才能支持页眉和页脚。请参阅我们的“wiki <https: github.com/odoo/odoo/wiki/wkhtmltopdf=””>”_,了解有关各种版本的更多详细信息。</https:></the>

对于具有从右到左界面的语言(例如阿拉伯语或希伯来语),需要包“rtlcss”:

  1. 使用您的首选包管理器下载并安** nodejs**(homebrewmacports)。

  2. 安装 rtlcss

    $ sudo npm install -g rtlcss
    

运行 Odoo

一旦设置了所有依赖项,就可以通过运行服务器的命令行界面“odoo-bin”来启动Odoo。它位于Odoo社区目录的根目录。

要配置服务器,您可以指定 :ref:命令行参数<reference/cmdline/server> 或 :ref:配置文件 <reference/cmdline/config>

小技巧

对于企业版,必须将“企业”插件的路径添加到“插件路径”参数中。请注意,它必须位于“插件路径”中的其他路径之前,才能正确加载插件。

常见的必要配置有:

  • PostgreSQL 用户和密码。Odoo除了“psycopg2的默认值<http://initd.org/psycopg/docs/module.html>”_之外没有默认值:通过端口“5432”上的UNIX套接字与当前用户连接,没有密码。

  • 超出默认值的自定义插件路径,以加载您自己的模块。

运行服务器的典型方法是:

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

Where CommunityPath is the path of the Odoo Community installation and mydb is the name of the PostgreSQL database.

警告

Mac上某些版本的python可能会导致以下错误消息:限流超出最大限制。在这种情况下,添加以下参数 --limit-memory-hard 0 以避免该问题。

After the server has started (the INFO log odoo.modules.loading: Modules loaded. is printed), open http://localhost:8069 in your web browser and log in with the base administrator account: Use admin for the Email and, again, admin for the Password. That’s it, you just logged into your own Odoo database!

小技巧

  • From there, you can create and manage new users.

  • The user account you use to log into Odoo’s web interface differs from the --db_user CLI argument.

Docker

有关如何将Odoo与Docker一起使用的完整文档可以在官方Odoo`docker image <https://hub.docker.com/_/odoo/>`_页面上找到。