安装

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

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

在线使用

这种方式是在生产中使用或试用Odoo最简单方法。

安装包安装

适用于测试、开发并可用于长期生产使用，需要一些额外的部署和维护工作。

源代码安装

源代码安装提供更大的灵活性。例如允许在同一系统上运行多个Odoo版本。适合开发，也可用于生产部署。

Docker

通常 docker 进行开发或部署，可以使用官方 docker base 镜像。

版本

Odoo有两个不同的版本 Editions :社区版和企业版。在 Odoo Online 上可以使用企业版，并且只有企业客户和合作伙伴才能访问代码。任何人都可以免费获得社区版本。

如果已经使用社区版本并希望升级到企业版，请参阅 Upgrade Community to Enterprise （除了 源代码安装 ）。

在线使用

Demo

使用 demo 实例是了解Odoo最简单的方法。它们是仅存活几个小时的共享实例，可用于浏览和使用，而无需付费。

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

Odoo Online

Odoo Online 很简单，完全由Odoo S.A管理和迁移，提供私有实例并免费开始。它可以用于探索和测试 Odoo，并进行非代码级自定义(即与自定义模块或Odoo应用商店不兼容)，而无需在本地安装。

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

与 demo 实例一样， SaaS 实例不需要本地安装，因此 Web 浏览器就足够了。

安装包安装

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

安装包会自动配置所有依赖项（对于社区版本），但可能很难保证是最新版本。

具有所有相关依赖项的官方社区版软件包可每日构建服务器 nightly 上获取。社区和企业软件包都可以从我们的下载页面下载 download_（必须以付费客户或合作伙伴身份登录才能下载企业软件包）。

Windows

  1. 从每日构建服务器 nightly （仅限社区）下载安装程序，或从下载页面（任何版本）下载 download Windows 安装程序。

  2. 执行下载的文件。

    警告

    在Windows 8 及以后的版本，可能会看到标题为”Windows已经保护您的电脑”的警告信息。
    点击 更多信息 然后点击 仍然运行 。

  3. 接受 UAC 提示。

  4. 按照步骤完成安装。

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

Linux

准备

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

$ sudo apt install postgresql -y

警告

wkhtmltopdf 不是通过 pip 安装的。必须手工安装 0.12.5 版本才能支持页眉页脚。有关各种版本的更多详细信息，请参阅 wiki 。

存储库

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

$ 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 命令来安装最新版。

注解

目前，企业版还没有每日构建存储库。

分发包

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

注解

Odoo 16.0 ‘deb’ 软件包目前支持 Debian 11 （Bullseye） 、 Ubuntu 20.04 （Focal） 或更高版本。

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

这将作为一个服务（service）安装Odoo，创建必要的 PostgreSQL 用户并自动启动服务。

警告

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

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

    $ sudo pip3 install xlwt

  • num2words python 软件包在 Debian Buster 和 Ubuntu 18.04 中都不存在。没有这个包会导致 l10n_mx_edi 模块出现问题，文本金额（Textual amounts 金额的格式化？千分符等？）的显示会出现问题。

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

    $ sudo pip3 install num2words

源代码安装

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

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

启动和停止服务比打包安装方式也更灵活和明确，并允许使用命令行参数覆盖设置，而无需编辑配置文件。

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

获取源代码

有两种方法可以获取 Odoo 的源代码： zip 包和 git 。

压缩包

社区版：

企业版：

Git

以下内容要求安装 Git ，并且需要具有 Git 命令的基本知识。要 Clone Git 仓库，可使用 HTTPS 或 SSH 方式Clone 。如果不知道两者之间的区别，最好的选择很可能是HTTPS。如果你正在学习入门开发人员教程 Getting started ，或者计划为 Odoo 源代码做出贡献，请选择SSH 。

注解

企业版Git存储库不包含完整的 Odoo 源代码 。它只是一个附加组件的集合。主代码在社区版本中。运行企业版本实际上意味着是运行社区版服务并将插件路径选项设置为企业版本的文件夹。需要同时克隆社区版和企业版存储库，才能正常安装企业版。参见 版本 以访问企业存储库。

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

注解

企业版git库不包含完整的Odoo源代码 。它只是一个附加组件的集合。主代码在社区版本中。运行企业版本实际上意味着是运行社区版服务平台，并将插件路径选项设置为企业版本的文件夹。需要同时克隆社区版和企业版存储库，才能正常安装企业版。

准备

Python

Odoo 需要 Python 3.7 或更高版本。浏览 Python’s download page 下载最新版本的 Python3 并安装。

在安装过程中，要选中 Add Python 3 to PATH ，然后单击 Customize Installation ，确保选中 pip 。

注解

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

C:\> python --version

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

C:\> pip --version

PostgreSQL

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

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

  1. 添加 PostgreSQL的 bin 目录 (默认 : C:\Program Files\PostgreSQL\<version>\bin) 到环境变量 PATH 中。

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

    1. 打开 pgAdmin 。

    2. 双击 server 创建连接。

    3. 选择 Object ‣ Create ‣ Login/Group Role 。

    4. 在 Role Name 字段中输入用户名(例如: odoo)。

    5. 打开 Definition 标签并输入密码(例如: odoo )，然后点击 保存 。

    6. 打开 Privileges 标签并切换 Can login? 点击 Yes 然后 Create database? 点击 Yes 。

依赖

在安装依赖项之前，必须下载并安装 Build Tools for Visual Studio 。出现提示时，在 workload 选项卡中选择 C++ build tools 并安装它们。

Odoo的依赖项列在社区版根目录 requirements.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. 编辑系统环境变量 PATH 添加 rtlcss.cmd 所在路径 (一般在 : C:\Users\<user>\AppData\Roaming\npm\)。

重要

wkhtmltopdf 不是通过 pip 安装的。必须手工安装 0.12.5 版本才能支持页眉页脚。有关各种版本的更多详细信息，请参阅 wiki 。

运行 Odoo

所有依赖项都设置好后，可通过运行 odoo-bin 来启动Odoo，这是服务的命令行界面。位于Odoo社区版根目录。

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

小技巧

对于企业版，必须在 addons-path 参数中添加 企业版 插件的路径。注意，该路径必须位于 addons-path 中的其他路径之前，这样插件才能正确加载。

常见的必要配置有:

  • PostgreSQL 用户和密码。

  • 自定义插件路径，以加载你自定义的模块。

运行服务器典型方式是：

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

其中 CommunityPath 是Odoo社区版的安装路径，dbuser 是 PostgreSQL的登录名， dbpassword 是PostgreSQL的密码， mydb 是 PostgreSQL 数据库的名称。

服务启动后( INFO日志中看到 odoo.modules.loading: Modules loaded. )，在浏览器中打开地址 http://localhost:8069 ，用基本管理员账号登录， Email 填写 admin ， Password 填写 admin ！

小技巧

  • 从这里创建和管理新用户 users 。

  • 用于登录Odoo web界面的用户帐户与 --db_user CLI参数不同。

参见

odoo-bin CLI参数的详细列表.

Docker

关于如何在 Docker 中使用 Odoo 的完整文档可以在 Odoo 的官方 https://hub.docker.com/_/odoo/ 页面上找到。