¶ 安裝及環境需求
以下指南將介紹如何在 Ubuntu 伺服器上安裝 ERPNext。
如果當前登錄的是root用戶，就請新建一個用於安裝ERP的sudo用戶。如果已經有sudo組的用戶則可忽略這一步。
也可以參考 gitHub 上的說明
https://github.com/gexMichael/ERPNext-InstallNote/blob/main/ERPNEXT-v15-安裝指南.
¶ 新建一個用於安裝ERP的sudo用戶
sudo adduser frappe
### 要輸入密碼
sudo usermod -aG sudo frappe
¶ 使用上一步建好的sudo使用者登錄系統，更新系統並重啟系統
sudo apt update && sudo apt upgrade -y && sudo shutdown -r now
¶ 下載node.js
curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
¶ 安裝作業系統所需的各種依賴包
sudo apt install -y python3.10-dev python3-setuptools python3-pip python3-distutils python3.10-venv software-properties-common mariadb-server mariadb-client redis-server nodejs xvfb libfontconfig libmysqlclient-dev nginx git ansible pkg-config libcairo2-dev libjpeg-dev libgif-dev librsvg2-dev
¶ 接下來開始配置MariaDB，用nano編輯my.cnf文件。
sudo nano /etc/mysql/my.cnf
將游標移動到最後空白行，複製以下文本內容，粘貼後注意格式和換行要同下方，ctrl + X返回命令列，保存cy.cnf。
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[mysql]
default-character-set = utf8mb4
¶ 重啟sql
sudo service mysql restart
¶ 開始mysql的安全配置
sudo mysql_secure_installation
- 第一個輸入資料庫密碼對話方塊出來的時候，直接敲回車代表沒有密碼，剩下的按照下面選擇：
# 注：運行結果用 ··· 代替
Enter current password for root (enter for none): # 輸入root(mysql)的密碼，初次安裝預設沒有，直接回車
...
Switch to unix_socket authentication [Y/n] n # 是否切換到unix通訊身份驗證
...
Change the root password? [Y/n] y #是否設置root使用者密碼
New password: # 新密碼
Re-enter new password: # 再次輸入密碼
...
Remove anonymous users? [Y/n] y # 是否刪除匿名使用者，建議刪除
...
Disallow root login remotely? [Y/n] n # 是否禁止root遠端登入，建議不開啟
...
Remove test database and access to it? [Y/n] n # 是否刪除test資料庫
...
Reload privilege tables now? [Y/n] y # 是否重新載入許可權表，也可以直接回車
...
Thanks for using MariaDB! # 看到這句話證明設置成功
¶ 安裝yarn
sudo npm install -g yarn
¶ 查看版本，對照一下 (這一步不做也行).
node -v && npm -v && python3 -V && pip3 -V && yarn -v
¶ 安裝bench，即erpnext系統的命令列管理工具，類似windows系統的程式管理器。
sudo -H pip3 install frappe-bench
¶ 使用bench命令安裝frappe框架。frappe-bench是安裝frappe框架的目錄名稱。
bench init --frappe-branch version-15 frappe-bench --verbose
¶ 再將安裝的系統使用者分配一下執行許可權。
chmod -R o+rx /home/frappe/ 或
chmod 701 /home/frappe
¶ 進入bench目錄
cd frappe-bench
¶ 新建網站，下面是以erpnext作為網站名稱。
bench new-site erpnext
¶ 設置為生產環境，即用supervisorctl管理所有進程，使用nginx做反向代理。如果安裝只是為了做開發，可以跳過這一步。(建議安裝)
sudo bench setup production frappe
基本上到此已經可以輸入網址試試看能否看到登入頁，如果不行，請重新設定用戶權限，並重新執行上面的命令，通常就可以解決。
¶ 下載app (注意：一次只能執行一行指令)
bench get-app --branch version-15 payments
bench get-app --branch version-15 erpnext
bench get-app --branch version-15 hrms
¶ 如果萬一失敗，或是看到任何不尋常的 error msg，執行下面的語法
bench restart 或
bench reinstall 或
bench build
¶ 安裝app (注意：一次只能執行一行指令)
bench –-site erpnext install-app payments
bench –-site erpnext install-app erpnext
bench –-site erpnext install-app hrms
¶ 查看所需的app是否安裝正確，可以用這個命令
bench version
¶ 最後解決可能存在PDF列印中文顯示亂碼所需要的工具
wget https://gitee.com/qinyanwan/erpnext_end/releases/download/v13.29.0/wkhtmltox_0.12.6.1-2.jammy_amd64.deb
sudo dpkg -i wkhtmltox_0.12.6.1-2.jammy_amd64.deb
如果安裝提示有缺少依賴的錯誤，執行下面命令。
sudo apt -f install
現在，我們可以檢查wkhtmltopdf 庫是否正確安裝並確認是否為所需版本：
顯示wkhtmltopdf 0.12.6 (with patched qt)即是正確版本
wkhtmltopdf –version
¶ 如匯出PDF亂碼，需要另外安裝字體
sudo apt-get install ttf-wqy-zenhei -y
sudo apt-get install ttf-wqy-microhei -y
¶ 接下來是中文化的步驟
- 獲取對應版本APP
bench get-app https://gitee.com/yuzelin/erpnext_chinese.git
- 安裝APP(有多個網站且未設默認網站的請加--site參數)
bench install-app erpnext_chinese
¶ 開箱即用(ERPNext Out of Box)
- 獲取對應版本APP
bench get-app --branch version-15 https://gitee.com/yuzelin/erpnext_oob.git
- 安裝APP
bench install-app erpnext_oob
¶ 前面的安裝是針對簡體中文的安裝，要轉為正體中文，還需要執行下列步驟
- 將簡體中文的翻譯檔，轉為正體中文
zh.csv 轉為 zh-TW.csv
zh_global.csv 轉為 zh-TW_global.csv
可以透過下面的網站轉換
https://zhconvert.org/
- 請到 GitHub 複製檔案到主機的下列目錄
/home/frappe/frappe-bench/apps/erpnext_chinese/erpnext_chinese/translations/zh-TW.csv
/home/frappe/frappe-bench/apps/erpnext_oob/erpnext_oob/translations
¶ 成功安裝後，要記得啟動，然後就可以開啟 ERPNext 之旅
bench start