最後更新：2016 年 11 月 1 日 (Redmine 3.3 on Deb. 8 (64 位元))
從我的網站下載原始文件的 PDF 檔：http://files.hz6.de/redmine/InstallingRedmine_EN.pdf
德文版本 請至 http://files.hz6.de/redmine/InstallingRedmine_DE.pdf
閱讀完本指南後，您應該擁有一個可以運作的 Redmine 執行個體.
如果沒有，或者步驟失敗，請在論壇上發布詳細資訊並參考此 Wiki 頁面。請務必包含 gem env 和/或 RAILS_ENV=production /opt/redmine/script/about 的輸出。
如果本指南有任何問題，請與我聯絡或自行更正。
關於本指南¶
這是在「Debian stable」（撰寫本文時稱為 Wheezy）上安裝 Redmine 的逐步指南。
它是為熟悉 Debian、Shell、MySQL、Apache 和 Linux 的人而寫的。
為了簡潔起見，本指南不會詳細說明每個步驟。
本文檔中的版本、檔案名稱和路徑可能會經常變更。我會盡力保持最新狀態，但請務必再次確認。
請注意： 我假設您知道如何使用手邊的工具。如果不知道（例如，您不知道如何建立新的資料庫，或者您不知道如何重新啟動 Apache），請使用您選擇的搜尋引擎，然後再回來。
第 1 章：安裝 Ruby、Rails、Gems 和 Passenger¶
閱讀第 1 章閱讀第 1 章
1.1 準備您的系統¶
apt-get install gcc build-essential zlib1g zlib1g-dev zlibc libssl-dev libyaml-dev libcurl4-openssl-dev apache2-mpm-prefork apache2-dev libapr1-dev libxslt1-dev checkinstall
apt-get build-dep ruby
1.2 下載、建置和安裝 Ruby¶
再次檢查是否符合此處的規定
https://redmine.dev.org.tw/projects/redmine/wiki/RedmineInstall
cd ~
wget -c ftp://ftp.ruby-lang.org/pub/ruby/2.3/ruby-2.3.1.tar.gz
tar xvfz ruby-2.3.1.tar.gz
cd ruby-2.3.1
./configure --enable-pthread --prefix=/usr/local
- 仔細閱讀並檢查輸出 :)
- 如有需要，新增遺漏的套件
make
su
checkinstall --type=debian --install=yes --fstrans=no --pakdir='~'
1.3 檢查 Ruby 是否正常運作¶
預期輸出：ruby 2.3.1pXXX (2016-06-27 revision 41675) [x86_64-linux]
ruby –v
1.4 讓 Ruby 支援 OpenSSL¶
cd ext/openssl/
ruby extconf.rb
make
su
checkinstall --type=debian --install=yes --fstrans=no --pakdir='~'
1.5 gem 是否已安裝？¶
Ruby 1.9 預設包含 RubyGems，因此現在應該已經安裝了 gem。如果安裝正確，以下指令將輸出版本號碼，例如 1.8.2x
gem -v
我們現在可以安裝 rdoc
gem install rdoc
1.6 安裝 Rails¶
與這裡的版本核對
https://rubygems.org/gems/rails/versions
https://redmine.dev.org.tw/projects/redmine/wiki/RedmineInstall
並強制指定版本號碼（否則將安裝最新版本）
gem install rails -v=4.2.7.1 --no-ri --no-rdoc
注意：您可能會收到錯誤訊息「
"no such file to load --zlib (LoadError)"」。在這種情況下，
您需要先安裝 zlib
cd ruby-1.9.3-p547/ext/zlib/
ruby extconf.rb
make
make install
1.7 安裝 Passenger（應用程式伺服器）¶
gem install passenger
passenger-install-apache2-module
1.8 設定 Apache¶
將以下內容放入 /etc/apache/mods-available/passenger.load（如有必要，請記得調整路徑）。
LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.46/ext/apache2/mod_passenger.so
並將以下內容放入 /etc/apache/mods-available/passenger.conf（如有必要，請記得調整路徑）。
PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.46
PassengerRuby /usr/local/bin/ruby
PassengerDefaultUser www-data
1.9 啟用模組¶
a2enmod passenger
第 2 章：安裝 Redmine¶
閱讀第 2 章閱讀第 2 章
2.1 下載 Redmine¶
從 這裡 取得最新的壓縮檔並解壓縮至 /opt/redmine
2.2 進一步準備系統¶
注意：安裝 libmagickwand-dev 會安裝許多套件（依賴 / 建議）
注意：如果您遇到 bundle install 錯誤，您可以嘗試清除，然後安裝 *-dev 套件
gem install bundler mysql2
apt-get install libmagickwand-dev libmysqlclient-dev
cd /opt/redmine
bundle install --without postgresql
2.3 建立資料庫¶
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'XXX';
grant all privileges on redmine.* to 'redmine'@'localhost';
2.4 設定資料庫連線¶
將以下內容放入 /opt/redmine/config/database.yml
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: XXX
2.5 產生 Session Store 金鑰¶
rake generate_secret_token
2.6 準備資料庫 / 建立資料表¶
RAILS_ENV=production rake db:migrate
2.7 設定檔案系統權限¶
cd /opt/redmine
mkdir tmp tmp/pdf public/plugin_assets
chown -R www-data:www-data files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets
2.8 測試是否正常運作¶
Redmine 2.x.x
ruby script/rails server webrick -e production
Redmine 3.x.x
bundle exec rails server webrick -e production
現在前往 https://127.0.0.1:3000 即可看到 Redmine 的運作。
第 3 章：設定 Apache 和 Passenger¶
在本指南中，我們部署到子 URI。如果您需要基於名稱的虛擬主機設定，請閱讀其他指南。
閱讀第 3 章閱讀第 3 章
3.1 設定 Apache（子 URI 部署）¶
ln -s /opt/redmine/public /var/www/redmine
將以下內容放入 /etc/apache2/sites-available/redmine
注意：選項「RackBaseURI」適用於 Rails 3，在 Rails 2 中稱為「RailsBaseURI」。它絕對不稱為「RakeBaseURI」。
<Location /redmine>
RailsEnv production
RackBaseURI /redmine
Options -MultiViews
</Location>
重新啟動 Apache，測試 http://yourhost.com/redmine 是否正常運作，如果可以的話，恭喜您 :-)
如果您看到任何異常，請在論壇上發布詳細資訊並參考此 Wiki 頁面。請務必包含 gem env 和 / 或 RAILS_ENV=production /opt/redmine/script/about 的輸出。