Redmine 超詳細安裝教學:Redmine 4.1.1 on Ubuntu 16.04

林鼎淵
Dean Lin
Published in
6 min readFeb 18, 2021

--

專案管理的工具非常之多,但是 jira、notion、clickup、trello 這類的專案管理都需要付錢,目前公司採用 Teams 的 planner、Lists 又不符合實際使用情境;之前有短暫的導入 testlink,不過那個 20 年前的 UI 設計很快就勸退大家。基於上述原因決定嘗試使用 Redmine 這個專案管理工具,本篇文章會詳細說明安裝的步驟即遭遇過的問題,文章大綱如下:

一、安裝環境二、安裝順序
STEP 1:安裝 MySQL
STEP 2:建立 Redmine 使用者帳號
STEP 3:安裝 RVM
STEP 4:安裝 Ruby
STEP 5:安裝 Passenger and Nginx
STEP 6:設定 Nginx
STEP 7:在 MySQL 增加 redmine 的使用者
STEP 8:安裝 Redmine
STEP 9:安裝 Redmine 外掛
STEP 10:設定 Redmine 寄信功能
三、備註

一、安裝環境

官方沒有建議的硬體規格,但是看到有 文章分享 最低硬體配置如下:

  • Processor: Intel Celeron (min 300 MHz)
  • RAM: 1–2 GB RAM
  • HDD: 30–40 GB

但通常使用最低硬體配置得到的結果就是容易卡,很多人同時上線使用時會讓卡到讓你懷疑人生,下面是我安裝時的配置目前使用起來算是流暢給大家參考用:

  • Processor: 使用 VMWARE 的虛擬單核心
  • RAM: 8GB RAM
  • HDD: 500 GB
  • OS: ubuntu 16.04

二、安裝順序

操作時請注意角色權限(root、redmine),否則安裝到一半會卡住

STEP 1:安裝 MySQL

角色: root

看到類似上方的 MySQL 資訊就代表你安裝成功嚕!

STEP 2:建立 Redmine 使用者帳號

角色: root

STEP 3:安裝 RVM

角色: redmine

看到類似上方的 RVM 資訊就代表你安裝成功嚕!

STEP 4:安裝 Ruby

角色: redmine

作者的 RUBY_VERSION 為 2.3.8,這裡安裝的版本請參考 Redmine 的官方建議,如果安裝其他的版本後續安裝 Redmine 時會發生錯誤

看到類似上方的 ruby 資訊就代表你安裝成功嚕!

STEP 5:安裝 Passenger and Nginx

角色: root

STEP 6:設定 Nginx

角色: root

完成上述步驟後再做以下驗證:

  1. 更改目錄權限: chown -R www-data /var/www
  2. 重啟 Nginx: systemctl restart nginx
  3. 驗證 Passenger and NGINX: /usr/bin/passenger-config validate-install

4. 檢查 Ngninx 狀態與 Passenger process: /usr/sbin/passenger-memory-stats

STEP 7:在 MySQL 增加 redmine 的使用者

角色: root

STEP 8:安裝 Redmine

角色: redmine

➤ 下載官方 image

➤ 調整 redmine 裡面的資料庫設定

➤ 下載相關套件

➤ 初始化 redmine

接下來你可以瀏覽 http:<server_ip> ,如果順利的話可以看到 Redmine 登入畫面如下:

預設 admin/admin 登入

STEP 9:安裝 Redmine 外掛

角色: redmine

Plugin 安裝方式雷同,下面以 Redmine Dashboard 2為範例安裝

安裝成功後的外掛程式會直接出現喔~

STEP 10:設定 Redmine 寄信功能

角色: redmine

如果沒做這個步驟是寄不出信的,需要做下面的調整即可

設定前在:網站管理>設定>電子郵件提醒選項。會出現的畫面
網站管理>設定>電子郵件提醒選項的右下角會有“寄送測試郵件的按鈕”提供測試喔
收到的測試郵件會長這個樣子

三、備註

  1. 如果進入網頁時畫面沒有顯示應該是因為防火牆問題,可以用下面指令嘗試:sudo ufw allow httpsudo ufw allow https
  2. 參考資源:Redmine 安裝篇:Redmine 4.0.x on Ubuntu 16.04Redmine Plugins and ThemesHowTo Install Redmine on Ubuntu step by step

🙂 讀完這篇文章後

▶︎ 如果這篇文章有幫助到你1. 可以點擊下方「Follow」來追蹤我~
2. 可以對文章拍手讓我知道 👏🏻
你們的追蹤與鼓勵是我繼續寫作的動力 🙏🏼▶︎ 如果你對工程師的職涯感到迷茫1. 也許我在iT邦幫忙發表的系列文可以給你不一樣的觀點 💡
2. 也歡迎您到書局選購支持,透過豐富的案例來重新檢視自己的職涯

--

--

林鼎淵
Dean Lin

職涯中培育過多名工程師,🧰 目前在外商公司擔任 Software Specialist |✍️ 我專注寫 (1)最新技術 (2)團隊合作 (3)工程師職涯的文章,出版過 5 本專業書籍|👏🏻 如果對這些主題感興趣,歡迎點擊「Follow」來關注我~