Source install

源代码 ‘installation’ 并不是安装 Odoo,而是直接从源代码运行。

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

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

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

获取源

获取 Odoo 源代码有两种方式:ZIP 压缩包 或通过**Git**。

存档

社区版:

企业版

Git

注解

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

要克隆一个 Git 存储库,请选择使用 HTTPS 或 SSH 进行克隆。在大多数情况下,最好的选择是HTTPS。然而,如果要为 Odoo 源代码做贡献或者遵循:doc:入门开发者教程</developer/tutorials/getting_started>,请选择 SSH。

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

注解

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

准备

Python

Odoo requires Python 3.7 or later to run.

使用软件包管理器下载并安装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 依赖项。

For Debian-based systems, the packages are listed in the debian/control file of the Odoo sources.

在 Debian/Ubuntu 上,使用以下命令即可安装所需的软件包:

$ cd /CommunityPath
$ sed -n -e '/^Depends:/,/^Pre/ s/ python3-\(.*\),/python3-\1/p' debian/control | sudo xargs apt-get install -y

注解

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

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

  2. 安装 rtlcss

    $ sudo npm install -g rtlcss
    

警告

wkhtmltopdf` 无法通过 pip 安装,必须手动安装到 version 0.12.6 才能支持页眉和页脚。请查看 wkhtmltopdf wiki 了解有关不同版本的更多详情。

运行 Odoo

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

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

小技巧

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

常见的必要配置有:

  • PostgreSQL 用户和密码。

  • 可以在默认路径之外设置自定义插件路径以加载自定义模块。

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

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

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

服务器启动后(打印 INFO 日志 odoo.modules.loading: Modules loaded.),在网络浏览器中打开 http://localhost:8069,使用基本管理员账户登录 Odoo 数据库:使用 admin 作为电子邮件,同样使用 admin 作为密码。

小技巧

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

  • 用于登录 Odoo 网页界面的用户账户与 --db_user CLI 参数不同。