Source

源代码 ‘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 -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 is not installed through pip and must be installed manually in version 0.12.5 for it to support headers and footers. Check out the wkhtmltopdf wiki for more details on the various versions.

运行 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 作为密码。

小技巧

  • From there, create and manage new users.

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