安装 Odoo

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

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

线上

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

打包安装程序

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

Source install

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

Docker

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

版本

There are two different Editions of Odoo: the Community and Enterprise versions. Using the Enterprise version is possible on Odoo Online and accessing the code is restricted to Enterprise customers and partners. The Community version is freely available to anyone.

如果您已经使用社区版本并希望升级到企业版，请参阅 从社区版升级到企业版 （除了 Source install).

线上

样例

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

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

Odoo云端版本

Trivial to start with, fully managed and migrated by Odoo S.A., Odoo Online provides private instances and starts out free. It can be used to discover and test Odoo and do non-code customizations (i.e. incompatible with custom modules or the Odoo Apps Store) without having to install it locally.

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

Like demo instances, Odoo Online instances require no local installation, a web browser is sufficient.

打包安装程序

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

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

Official Community packages with all relevant dependency requirements are available on our nightly server. Both Community and Enterprise packages can be downloaded from our download page (you must to be logged in as a paying customer or partner to download the Enterprise packages).

Windows

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

2. 执行下载的文件。

   警告

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

   单击“ 多信 ”，然后单击“仍然运行”。<

3. 接受UAC_提示。

4. 完成各种安装步骤。

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

Linux

准备

Debian/UbuntuFedora

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>

存储库

Debian/UbuntuFedora

Odoo S.A. provides a repository that can be used with Debian and Ubuntu distributions. It can be used to install Odoo Community Edition by executing the following commands:

$ wget -q -O - https://nightly.odoo.com/odoo.key | sudo gpg --dearmor -o /usr/share/keyrings/odoo-archive-keyring.gpg
$ echo 'deb [signed-by=/usr/share/keyrings/odoo-archive-keyring.gpg] https://nightly.odoo.com/16.0/nightly/deb/ ./' | sudo tee /etc/apt/sources.list.d/odoo.list
$ sudo apt-get update && sudo apt-get install odoo

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

注解

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

Distribution package

Debian/UbuntuFedora

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

注解

Odoo 16 ‘deb’ package currently supports Debian 11 (Bullseye), Ubuntu 22.04 (Jammy) or above.

接下来，以 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
  

Source install

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

It can be more convenient for module developers as the Odoo source is more easily accessible than using packaged installation.

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

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

获取源

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

存档

(社区版)

• 官方下载页面<download_>

• GitHub repository

• “夜间服务器<nightly>”_

（企业版）

• 官方下载页面<download_>

• GitHub repository

Git

The following requires Git to be installed on your machine and that you have basic knowledge of Git commands. To clone a Git repository, you must choose between cloning with HTTPS or SSH. If you do not know the difference between the two, the best option is most likely HTTPS. If you are following the Getting started developer tutorial, or plan on contributing to Odoo source code, choose SSH.

WindowsLinuxMac OS

Clone with HTTPSClone with SSH

C:\> git clone https://github.com/odoo/odoo.git
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. See 版本 to get access to the Enterprise repository.

准备

Python

WindowsLinuxMac OS

Odoo需要Python 3.7或更高版本才能运行。访问“Python的下载页面<https://www.python.org/downloads/windows/>”_在您的计算机上下载并安装最新版本的Python 3。

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

注解

如果已经安装了Python 3，请确保版本为3.7或更高版本，因为以前的版本与Odoo不兼容。

C:\> python --version

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

C:\> pip --version

PostgreSQL

WindowsLinuxMac OS

Odoo uses PostgreSQL as database management system. Download and install PostgreSQL (supported version: 12.0 and later).

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

1. Add PostgreSQL’s bin directory (by default: C:\Program Files\PostgreSQL\<version>\bin) to your PATH.

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

   1. 打开 pgAdmin。

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

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

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

   5. Open the Definition tab and enter the password (e.g. odoo), then click Save.

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

依赖

WindowsLinuxMac OS

在安装依赖项之前，必须下载并安装“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

对于具有从右到左界面的语言（例如阿拉伯语或希伯来语），需要包“rtlcss”：

1. 下载并安装 nodejs。

2. 安装 rtlcss：

   C:\> npm install -g rtlcss
   

3. Edit the System Environment’s variable PATH to add the folder where rtlcss.cmd is located (typically: C:\Users\<user>\AppData\Roaming\npm\).

重要

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

运行 Odoo

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

要配置服务器，您可以指定 命令行参数 或 配置文件。

小技巧

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

常见的必要配置有：

• PostgreSQL 用户和密码。

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

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

WindowsLinuxMac OS

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.

参见

The exhaustive list of CLI arguments for odoo-bin.

Docker

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