安裝Odoo?

根據預期的使用情況,安裝Odoo有多種方式,或者根本不安裝。

本文檔試圖描述大部分安裝選項。

線上

在生產環境中使用或嘗試Odoo的最簡單方法。

打包安裝程序

適用于測試Odoo,開發模塊,并可用于長期生產使用,但需要進行額外的部署和維護工作。

源代碼安裝

提供更大的靈活性:例如,在同一系統上允許多個運行中的Odoo版本。適用于開發模塊,可用作生產部署的基礎。

Docker

如果您通常使用docker_進行開發或部署,則有一個官方的docker_基礎鏡像可用。

版本?

Odoo 有兩個不同的版本:社區版和企業版。企業版可在 Odoo Online 上使用,訪問代碼僅限于企業客戶和合作伙伴。社區版對任何人都是免費的。

如果您已經使用社區版并希望升級到企業版,請參考: 將社區版升級為企業版 (除了 源代碼安裝 )。

線上?

演示?

為了快速了解Odoo,可以使用demo_實例。這些實例是共享的,只存在幾個小時,可以用來瀏覽和嘗試各種功能,而不需要做出承諾。

演示實例不需要本地安裝,只需要一個網絡瀏覽器。

Odoo 在線?

易于入門,由Odoo S.A.全面管理和遷移, Odoo Online 提供私有實例并且開始是免費的。它可以用于發現和測試Odoo,進行非代碼定制(即與自定義模塊或Odoo應用商店不兼容)而無需在本地安裝。

可用于測試Odoo和長期生產使用。

與演示實例一樣, Odoo Online 實例無需本地安裝,只需使用 web 瀏覽器即可。

打包安裝程序?

Odoo為社區版和企業版提供了Windows、基于deb的發行版(Debian、Ubuntu等)和基于RPM的發行版(Fedora、CentOS、RHEL等)的打包安裝程序。

這些軟件包會自動設置所有依賴項(適用于社區版),但可能難以保持最新狀態。

我們的夜間服務器上提供了所有相關依賴要求的官方社區軟件包。社區和企業軟件包都可以從我們的下載_頁面下載(您必須以付費客戶或合作伙伴的身份登錄才能下載企業軟件包)。

Windows?

  1. 從我們的 nightly 服務器(僅限社區版)或下載_ 頁面(任何版本)下載安裝程序。

  2. 執行已下載的文件。

    警告

    在 Windows 8 及更高版本中,您可能會看到一個名為“Windows 保護您的計算機”的警告。
    點擊 更多信息 ,然后點擊 仍要運行 。
  3. 接受 UAC 提示。

  4. 按照各種安裝步驟進行操作。

安裝結束后,Odoo 將自動啟動。

Linux?

準備?

Odoo需要一個 `PostgreSQL`_服務器才能正常運行。Odoo ‘deb’軟件包的默認配置是使用與您的Odoo實例相同主機上的PostgreSQL服務器。執行以下命令以安裝PostgreSQL服務器:

$ sudo apt install postgresql -y

警告

wkhtmltopdf 沒有通過 pip 安裝,必須手動安裝版本為 0.12.5,才能支持頁眉和頁腳。請參閱我們的 wiki,了解更多版本的詳細信息。

軟件倉庫?

Odoo S.A. 提供了一個可以與 Debian 和 Ubuntu 發行版一起使用的軟件倉庫。您可以通過執行以下命令來安裝 Odoo 社區版

$ wget -q -O - https://nightly.odoo.com/odoo.key | sudo gpg --dearmor -o /usr/share/keyrings/odoo-archive-keyring.gpg
$ echo 'deb [signed-by=/usr/share/keyrings/odoo-archive-keyring.gpg] https://nightly.odoo.com/16.0/nightly/deb/ ./' | sudo tee /etc/apt/sources.list.d/odoo.list
$ sudo apt-get update && sudo apt-get install odoo

您可以使用常規的 apt-get upgrade 命令來保持您的安裝程序最新。

注解

目前,企業版沒有夜間倉庫。

分發包?

與其按照上述描述使用存儲庫,不如從 官方下載頁面 下載 社區版企業版 的 ‘deb’ 包。

注解

Odoo 16的’deb’軟件包目前支持 Debian 11(Bullseye), `Ubuntu 22.04(Jammy)`_或更高版本。

接下來,請以 root 用戶身份執行以下命令:

# dpkg -i <path_to_installation_package> # this probably fails with missing dependencies
# apt-get install -f # should install the missing dependencies
# dpkg -i <path_to_installation_package>

這將安裝Odoo作為服務,創建必要的PostgreSQL_用戶并自動啟動服務器。

警告

  • python3-xlwt Debian軟件包在Debian Buster和Ubuntu 18.04中不存在。此Python模塊需要用于導出為xls格式。

    如果您需要此功能,可以手動安裝:

    $ sudo pip3 install xlwt
    
  • num2words Python包在Debian Buster和Ubuntu 18.04中不存在。Odoo將無法呈現文本金額,這可能會導致 l10n_mx_edi 模塊出現問題。

    如果您需要此功能,可以手動安裝:

    $ sudo pip3 install num2words
    

源代碼安裝?

“安裝”源實際上是指不安裝Odoo,而是直接從源代碼運行它。

對于模塊開發人員來說,使用Odoo源代碼比使用打包安裝更方便。

相比于打包安裝程序設置的服務,它還使得啟動和停止Odoo更加靈活和明確,并且允許使用 命令行參數 覆蓋設置,而無需編輯配置文件。

最后,它提供了對系統設置的更大控制,并允許更輕松地保留(和運行)多個版本的Odoo并排運行。

獲取源代碼?

有兩種方式可以獲取Odoo的源代碼:作為zip 歸檔文件 或通過 git 。

歸檔?

社區版:

企業版:

Git?

以下操作需要在您的計算機上安裝 Git 并且您需要基本的 Git 命令知識。要克隆 Git 存儲庫,您必須選擇使用 HTTPS 或 SSH 進行克隆。如果您不知道兩者之間的區別,最好的選擇很可能是 HTTPS。如果您正在遵循 入門指南 開發者教程,或者計劃貢獻于 Odoo 源代碼,請選擇 SSH。

注解

企業版Git倉庫不包含完整的Odoo源代碼 。它只是額外插件的集合。主要的服務器代碼在社區版中。運行企業版實際上意味著使用社區版中的服務器并將addons-path選項設置為企業版文件夾。您需要克隆社區版和企業版倉庫才能擁有一個可用的Odoo企業版安裝。請參閱 版本 以獲取訪問企業版倉庫的權限。

C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git

注解

企業版 Git 倉庫不包含完整的 Odoo 源代碼 。它只是一組額外的插件。主要的服務器代碼在社區版中。運行企業版實際上意味著使用社區版中的服務器,并將 addons-path 選項設置為企業版文件夾。您需要克隆社區版和企業版倉庫才能擁有一個可用的 Odoo 企業版安裝。

準備?

Python?

Odoo需要Python 3.7或更高版本才能運行。請訪問 `Python下載頁面 <https://www.python.org/downloads/windows/>`_下載并安裝最新版本的Python 3到您的計算機。

安裝過程中,請勾選 Add Python 3 to PATH ,然后點擊 Customize Installation 并確保 pip 已被勾選。

注解

如果已經安裝了Python 3,請確保版本為3.7或更高版本,因為早期版本與Odoo不兼容。

C:\> python --version

同時確認已安裝此版本的 pip。

C:\> pip --version

PostgreSQL?

Odoo使用PostgreSQL作為數據庫管理系統。 `下載并安裝PostgreSQL <https://www.postgresql.org/download/windows/>`_(支持的版本:12.0及更高版本)。

默認情況下,唯一的用戶是 postgres ,但是Odoo禁止使用 postgres 進行連接,因此您需要創建一個新的PostgreSQL用戶:

  1. 將PostgreSQL的 bin 目錄(默認為: C:\Program Files\PostgreSQL\<version>\bin )添加到您的 PATH 中。

  2. 使用pg admin gui創建帶密碼的postgres用戶:

    1. 打開 pgAdmin 。

    2. 雙擊服務器以創建連接。

    3. 選擇 對象 ? 創建 ? 登錄/組角色 。

    4. 角色名稱 字段中輸入用戶名(例如 odoo )。

    5. 打開 定義 選項卡,輸入密碼(例如 odoo ),然后單擊 保存 。

    6. 打開 權限 選項卡,將 Can login? 切換為 ,將 Create database? 切換為 。

依賴項?

在安裝依賴項之前,您必須下載并安裝 Visual Studio Build Tools。在提示時,在 Workloads 選項卡中選擇 C++ build tools 并安裝它們。

Odoo 的依賴項列在位于 Odoo 社區目錄根目錄下的 requirements.txt 文件中。

小技巧

最好不要在不同的Odoo實例或系統之間混合使用Python模塊包。您可以使用virtualenv_創建隔離的Python環境。

導航到您的Odoo社區安裝路徑( CommunityPath ),并在終端中 以管理員權限 運行要求文件上的 pip 命令:

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

對于從右到左的界面語言(如阿拉伯語或希伯來語),需要安裝 rtlcss 包:

  1. 下載并安裝 nodejs。

  2. 安裝 rtlcss

    C:\> npm install -g rtlcss
    
  3. 編輯系統環境變量 PATH ,將包含 rtlcss.cmd 的文件夾添加進去(通常在 C:\Users\<user>\AppData\Roaming\npm\ )。

重要

wkhtmltopdf 沒有通過 pip 安裝,必須手動安裝版本為 0.12.5,才能支持頁眉和頁腳。請參閱我們的 wiki,了解更多版本的詳細信息。

運行Odoo?

一旦所有依賴項都設置好了,可以通過運行 odoo-bin 來啟動Odoo,這是服務器的命令行界面。它位于Odoo社區目錄的根目錄下。

要配置服務器,您可以指定 命令行參數 或者 配置文件 。

小技巧

對于企業版,您必須將 enterprise 插件的路徑添加到 addons-path 參數中。請注意,它必須在 addons-path 中的其他路徑之前,以便正確加載插件。

常見的必要配置包括:

  • PostgreSQL 用戶名和密碼。

  • 自定義插件路徑,超出默認路徑,以加載您自己的模塊。

運行服務器的典型方式是:

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

其中 CommunityPath 是 Odoo 社區版安裝路徑, dbuser 是 PostgreSQL 登錄名, dbpassword 是 PostgreSQL 密碼, mydb 是 PostgreSQL 數據庫名稱。

服務器啟動后(INFO日志 odoo.modules.loading: Modules loaded. 打印出來),在您的Web瀏覽器中打開 http://localhost:8069 并使用基本管理員帳戶登錄:在 Email 中使用 admin ,在 Password 中再次使用 admin 。這就是了,您剛剛登錄了自己的Odoo數據庫!

小技巧

  • 從那里,您可以創建和管理新的 用戶 。

  • 您用于登錄Odoo Web界面的用戶帳戶與CLI參數 --db_user 不同。

Docker?

您可以在官方Odoo `docker鏡像<https://hub.docker.com/_/odoo/>`_頁面找到有關如何使用Docker的完整文檔。