原始碼安裝¶

原始碼「安裝」並非安裝 Odoo，而是直接從原始碼執行它。

使用 Odoo 原始碼對模組開發者來說可能更方便，因為它比使用套件安裝程式更容易存取。

這使得啟動和停止 Odoo 比套件安裝程式設定的服務更靈活和明確。此外，它允許使用指令列參數覆寫設定，而無需編輯配置檔案。

最後，它提供對系統設定的更大控制，並允許更輕鬆地保留（和執行）多個並行的 Odoo 版本。

獲取程式原始碼¶

你有兩種方式可獲取 Odoo 的原始碼：以 ZIP 壓縮檔 形式，或透過 Git 取得。

壓縮檔¶

社群版：

企業版：

Git¶

備註

需要安裝 Git，並建議具備 Git 指令的基本知識才能繼續。

要複製 Git 版本庫，請選擇使用 HTTPS 或 SSH 進行複製。在大多數情況下，最佳選項是 HTTPS。但是，若要為 Odoo 原始碼做出貢獻或在遵循入門開發者教學時，請選擇 SSH。

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git

$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git

$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@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.10 或以上，因為先前的版本與 Odoo 不相容。

$ python3 --version

C:\> python --version

$ python3 --version

驗證此版本是否也安裝了 pip。

$ pip3 --version

C:\> pip --version

$ pip3 --version

PostgreSQL¶

Odoo 使用 PostgreSQL 作為其資料庫管理系統。

在 19 版本變更: 最低需求從 PostgreSQL 12 更新為 PostgreSQL 13。

使用套件管理器下載並安裝 PostgreSQL（支援版本：13.0 或更高版本）。可透過執行以下指令完成：

$ sudo apt install postgresql postgresql-client

使用 Postgres.app 下載並安裝 PostgreSQL（支援版本：13.0 或更高版本）。

小訣竅

若要使 Postgres.app 隨附的命令列工具可用，請務必按照 Postgres.app CLI tools instructions 設定 $PATH 變數。

預設情況下,唯一的使用者是 postgres。由於 Odoo 禁止以 postgres 連線，請建立新的 PostgreSQL 使用者。

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

備註

由於 PostgreSQL 使用者與 Unix 登入名稱相同，因此可以在不使用密碼的情況下連線到資料庫。

將 PostgreSQL 的 bin 目錄（預設位置在 C:\Program Files\PostgreSQL\<版本編號>\bin ）加入至 PATH。
使用 pg admin gui 建立具有密碼的 postgres 使用者:
1. 開啟 pgAdmin 。
2. 按兩下伺服器，以建立連線。
3. 選擇物件 ‣ 建立 ‣ 登入/群組角色。
4. 在 角色名稱 欄位中，輸入使用者名稱（例： odoo ）。
5. 開啟定義分頁，輸入密碼（例： odoo ），然後按一下儲存。
6. 開啟權限分頁，將 可登入？ 切換為 是 ，並將 建立資料庫？ 也切換為 是 。

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

備註

由於 PostgreSQL 使用者與 Unix 登入名稱相同，因此可以在不使用密碼的情況下連線到資料庫。

備註

如果您想使用Odoo 的 AI 人工智能功能，則需要 pg-vector PostgreSQL 擴展。

請注意，pg-vector 僅適用於 PostgreSQL 15 及更高版本。

導航到您的臨時資料夾
```
$ cd /tmp
```

複製 pg-vector GitHub 儲存庫：

$ git clone https://github.com/pgvector/pgvector.git

導航到目錄中：
```
$ cd pgvector
```
編譯擴展：
```
$ make
```
安裝擴展：
```
$ sudo make install
```

如果在安裝過程中遇到任何問題，請務必查看官方的安裝說明。

導航到您的臨時資料夾
```
$ cd /tmp
```

複製 pg-vector GitHub 儲存庫：

$ git clone https://github.com/pgvector/pgvector.git

導航到目錄中：
```
$ cd pgvector
```
編譯擴展：
```
$ make
```
安裝擴展：
```
$ sudo make install
```

如果在安裝過程中遇到任何問題，請務必查看官方的安裝說明。

導航到您的臨時資料夾
```
$ cd %TEMP%
```

複製 pg-vector GitHub 儲存庫：

$ git clone https://github.com/pgvector/pgvector.git

導航到目錄中：
```
$ cd pgvector
```
確保在 Visual Studio 中安裝了 C++ 支援，並以管理員身份運行 x64 Native Tools Command Prompt for VS [version]。

設置您的 PGROOT 環境變數：

$ set "PGROOT=C:\Program Files\PostgreSQL\[Your PostgreSQL Version]"

編譯擴展：
```
$ nmake /F Makefile.win
```
安裝擴展：
```
$ nmake /F Makefile.win install
```

如果您在安裝過程中遇到任何問題，請務必查看官方`安裝說明<https://github.com/pgvector/pgvector#installation-notes---windows>`__。

依賴項目¶

使用**發行套件**是安裝相依性套件的首選方式。或者，使用 pip 安裝 Python 相依性套件。

在 Debian/Ubuntu 上，以下命令應該可以安裝所需的套件:

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

setup/debinstall.sh 指令碼將解析 debian/control 檔案並安裝找到的套件。

警告

使用 pip 可能會導致安全性問題和相依性損壞；只有在您知道自己在做什麼時才這樣做。

由於部分 Python 套件需要編譯步驟，因此需要安裝系統程式庫。

在 Debian/Ubuntu 上，以下命令應該可以安裝這些所需的程式庫:

$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

Odoo 相依性套件列在 Odoo Community 目錄根目錄的 requirements.txt 檔案中。

備註

requirements.txt 中的 Python 套件基於 Odoo 發布時穩定/LTS Debian/Ubuntu 對應版本。例如，對於 Odoo 15.0，Debian Bullseye 中的 python3-babel 套件版本為 2.8.0，Ubuntu Focal 中為 2.6.0。然後在 requirements.txt 中選擇最低版本。

小訣竅

最好不要在 Odoo 的不同執行個體之間或與系統混合使用 Python 模組套件。但是，可以使用 virtualenv 建立隔離的 Python 環境。

導覽至 Odoo Community 安裝路徑 (CommunityPath) 並在 requirements 檔案上執行 pip，為目前使用者安裝所需套件。

$ cd /CommunityPath
$ pip install -r requirements.txt

在安裝相依套件之前，請下載並安裝 Build Tools for Visual Studio。在 Workloads 分頁中選擇 C++ build tools，並在提示時進行安裝。

Odoo 相依套件列在 Odoo Community 目錄根目錄的 requirements.txt 檔案中。

小訣竅
最好不要在 Odoo 的不同執行個體之間或與系統混合使用 Python 模組套件。但是，可以使用 virtualenv 建立隔離的 Python 環境。

導航至 Odoo Community 安裝路徑 (CommunityPath)，並在**具有管理員權限**的終端機中對 requirements 檔案執行 pip：

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

Odoo 相依套件列在 Odoo Community 目錄根目錄的 requirements.txt 檔案中。

小訣竅
最好不要在 Odoo 的不同執行個體之間或與系統混合使用 Python 模組套件。但是，可以使用 virtualenv 建立隔離的 Python 環境。

導航至 Odoo Community 安裝路徑 (CommunityPath)，並對 requirements 檔案執行 pip：

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

警告

非 Python 的依賴項目，必須使用套件管理工具去安裝（ Homebrew 、 MacPorts ）。

下載並安裝 Command Line Tools：
```
$ xcode-select --install
```
使用套件管理工具，以安裝非 Python 的依賴項目。

備註

對於使用**由右至左介面**的語言（例如阿拉伯文或希伯來文），需要 rtlcss 套件。

使用套件管理工具，下載並安裝 nodejs 及 npm 。
安裝 rtlcss ：
```
$ sudo npm install -g rtlcss
```

下載並安裝 nodejs 。
安裝 rtlcss ：
```
C:\> npm install -g rtlcss
```
編輯系統環境變數 PATH，加入 rtlcss.cmd 所在的資料夾（通常為：C:\Users\<user>\AppData\Roaming\npm\）。

使用套件管理工具，下載並安裝 nodejs 。（套件管理工具： Homebrew 、 MacPorts ）。
安裝 rtlcss ：
```
$ sudo npm install -g rtlcss
```

警告

wkhtmltopdf 不透過 pip 安裝，必須手動安裝 version 0.12.6 才能支援頁首和頁尾。有關各版本的詳細資訊，請參閱 wkhtmltopdf wiki。

運行 Odoo¶

所有相依套件設定完成後，可以透過執行 odoo-bin 來啟動 Odoo，這是伺服器的命令列介面，位於 Odoo Community 目錄的根目錄。

若要配置伺服器，可以指定:ref:命令列引數 <reference/cmdline/server>`或:ref:`配置檔案 <reference/cmdline/config>。

小訣竅

對於 Enterprise 版本，請將 enterprise 附加元件的路徑加入至 addons-path 引數。請注意，它必須位於 addons-path 中其他路徑之前，附加元件才能正確載入。

通常必須提供的配置包括：

PostgreSQL 使用者名稱及密碼。
除了預設路徑外，用於載入自訂模組的自訂附加元件路徑。

執行伺服器的典型方式為：

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

其中 CommunityPath 是 Odoo Community 安裝路徑，mydb 是 PostgreSQL 資料庫名稱。

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

其中 CommunityPath 是 Odoo Community 安裝路徑，dbuser 是 PostgreSQL 登入名稱，dbpassword 是 PostgreSQL 密碼，mydb 是 PostgreSQL 資料庫名稱。

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

其中 CommunityPath 是 Odoo Community 安裝路徑，mydb 是 PostgreSQL 資料庫名稱。

伺服器啟動後（印出 INFO 日誌 odoo.modules.loading: Modules loaded.），在網頁瀏覽器中開啟 http://localhost:8069，並使用基本管理員帳戶登入 Odoo 資料庫：使用 admin 作為電子郵件，再次使用 admin 作為密碼。

小訣竅

接著，建立和管理新的:doc:使用者 <../../applications/general/users>。
用於登入 Odoo 網頁介面的使用者帳戶與 --db_user CLI 引數不同。

其他資料

odoo-bin 的 CLI 引數列表

在 GitHub 上編輯