源代码安装

源代码安装不是关于安装Odoo,而是直接从源代码运行它。

使用Odoo源代码对于模块开发人员来说更方便,因为它比使用打包安装程序更容易访问。

它使得启动和停止Odoo比打包安装程序设置的服务更加灵活和明确。此外,它允许使用 命令行参数 来覆盖设置,而无需编辑配置文件。

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

获取源代码

有两种获取Odoo源代码的方式:作为ZIP 存档 或通过 Git

归档

社区版:

企业版:

Git

注解

需要安装 Git ,并且建议具备基本的 Git 命令知识才能继续。

要克隆一个 Git 仓库,可以选择使用 HTTPS 或 SSH 进行克隆。在大多数情况下,最佳选择是 HTTPS。然而,如果要为 Odoo 源代码做贡献,或者按照 开发者入门教程 进行操作时,请选择 SSH。

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

注解

企业版 git 仓库不包含完整的 Odoo 源代码。它只是一组额外的插件。主要的服务器代码在社区版中。运行企业版意味着使用社区版中的服务器,并将 addons-path 选项设置为企业版所在的文件夹。必须克隆社区版和企业版仓库才能获得一个可用的 Odoo 企业版安装。

准备

Python

Odoo 需要 Python 3.10 或更高版本来运行。

在 17 版更改: 最低要求从 Python 3.7 更新到 Python 3.10。

如果需要,使用软件包管理器下载并安装Python 3。

注解

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

$ python3 --version

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

$ pip3 --version

PostgreSQL

Odoo 使用 PostgreSQL 作为其数据库管理系统。

使用软件包管理器下载和安装PostgreSQL(支持的版本:12.0或更高)。可以通过执行以下命令来实现:

$ sudo apt install postgresql postgresql-client

默认情况下,唯一的用户是 postgres。由于Odoo禁止使用 postgres 连接,需要创建一个新的PostgreSQL用户。

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

注解

由于PostgreSQL用户与Unix登录具有相同的名称,因此可以在没有密码的情况下连接到数据库。

依赖项

使用 发行版软件包 是安装依赖项的首选方式。或者,使用 pip 安装 Python 依赖项。

在Debian/Ubuntu上,以下命令应该安装所需的软件包:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

setup/debinstall.sh 脚本将解析 debian/control 文件并安装找到的软件包。

注解

对于使用 从右到左界面 的语言(如阿拉伯语或希伯来语),需要安装 rtlcss 软件包。

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

  2. 安装 rtlcss:

    $ sudo npm install -g rtlcss
    

警告

wkhtmltopdf 不是通过 pip 安装的,必须手动安装 版本 0.12.6 以支持页眉和页脚。查看 wkhtmltopdf wiki 以获取有关各个版本的更多详细信息。

运行 Odoo

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

要配置服务器,请指定 命令行参数 或者 配置文件

小技巧

对于企业版,请将路径添加到 enterprise 插件的 addons-path 参数中。请注意,它必须位于 addons-path 中的其他路径之前,以便正确加载插件。

常见的必要配置包括:

  • PostgreSQL 用户名和密码。

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

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

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

其中 CommunityPath 是 Odoo 社区版安装路径, mydb 是 PostgreSQL 数据库的名称。

启动服务器后(INFO日志 odoo.modules.loading: Modules loaded. 打印出来),在 Web 浏览器中打开 http://localhost:8069 并使用基本管理员账户登录 Odoo 数据库:将 admin 作为邮箱,再次将 admin 作为密码。

小技巧

  • 从那里,创建并管理新的 用户

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