安装 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¶

从我们的nightly_服务器（仅限社区）下载安装程序，或从download_页面（任何版本）下载 Windows 安装程序。
执行下载的文件。

警告

在 Windows 8 及更高版本上，您可能会看到标题为“Windows 保护您的 PC”的警告。

单击“ 多信 ”，然后单击“仍然运行”。<
接受UAC_提示。
完成各种安装步骤。

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

警告

存储库¶

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¶

The following requires git to be installed on your machine and that you have basic knowledge of git commands.

(社区版)

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

Enterprise Edition: (see 版本 to get access)

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

注解

The Enterprise git repository does not contain the full Odoo source code. It is only a collection of extra add-ons. The main server code is in the Community version. Running the Enterprise version actually means running the server from the Community version with the addons-path option set to the folder with the Enterprise version. You need to clone both the Community and Enterprise repository to have a working Odoo Enterprise installation.

准备¶

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用户：

将PostgreSQL的“bin”目录（默认情况下：“C：\Program Files\PostgreSQL\<version>\bin”）添加到您的“PATH”中。</version>
使用 pg admin gui 创建一个具有密码的 postgres 用户：
1. 打开 pgAdmin。
2. 双击服务器以创建连接。
3. 选择：menuselection：对象 --> 创建 --> 登录名/组角色。
4. 在“角色名称”字段中输入用户名（例如“odoo”）。
5. 打开“ **** ”选项卡并输入密码（例如“odoo”），然后单击“保存”。“。”odoo“（”odoo“）
6. 打开“权限”选项卡，将“可以登录？”切换为“是”，将“创建数据库？”切换为“是”。

运行 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 default database to serve on localhost:8069.

参见

The exhaustive list of arguments for odoo-bin.

Linux¶

获取源¶

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

存档¶

(社区版)

（企业版）

Git¶

The following requires git to be installed on your machine and that you have basic knowledge of git commands.

(社区版)

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

Enterprise Edition: (see 版本 to get access)

$ 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¶

一旦设置了所有依赖项，就可以通过运行服务器的命令行界面“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 default database to serve on localhost:8069.

参见

The exhaustive list of arguments for odoo-bin.

Mac OS¶

获取源¶

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

存档¶

(社区版)

（企业版）

Git¶

The following requires git to be installed on your machine and that you have basic knowledge of git commands.

(社区版)

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

Enterprise Edition: (see 版本 to get access)

$ 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`，但Odoo禁止以`postgres`的身份连接，所以你需要创建一个新的PostgreSQL用户：

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

注解

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

运行 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 default database to serve on localhost:8069.

参见

The exhaustive list of arguments for odoo-bin.

Docker¶

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

Edit on GitHub

安装 Odoo¶

版本¶

在线¶

样例¶

SaaS¶

打包安装程序¶

Windows¶

Linux¶

Debian/Ubuntu¶

准备¶

存储库¶

德布包¶

Fedora¶

准备¶

存储库¶

转速包¶

源安装¶

Windows¶

获取源¶

存档¶

Git¶

准备¶

Python¶

PostgreSQL¶

相关性¶

运行 Odoo¶

Linux¶

获取源¶

存档¶

Git¶

准备¶

Python¶

PostgreSQL¶

相关性¶

运行 Odoo¶

Mac OS¶

获取源¶

存档¶

Git¶

准备¶

Python¶

PostgreSQL¶

相关性¶

运行 Odoo¶

Docker¶