源代码安装

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

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

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

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

获取源代码

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

归档

社区版:

企业版:

Git

注解

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

To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code or when following the Getting Started developer tutorial.

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

注解

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

准备

Python

Odoo requires Python 3.10 or later to run.

在 17 版更改: Minimum requirement updated from Python 3.7 to Python 3.10.

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

注解

If Python 3 is already installed, make sure that the version is 3.10 or above, as previous versions are not compatible with 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

The setup/debinstall.sh script will parse the debian/control file and install the found packages.

注解

对于使用 从右到左界面 的语言(如阿拉伯语或希伯来语),需要安装 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.6 for it to support headers and footers. Check out the wkhtmltopdf wiki for more details on the various versions.

运行 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参数不同。