Windows環境へのRedmineのインストール（PostgreSQL版）

本記事では、Windows環境へのRedmineのインストール方法についてご紹介します。データベースとしてPostgreSQLを採用した内容になっています。MySQL版については以下の記事を参照ください。

＞＞Windows環境へのRedmineのインストール方法（MySQL版）はこちら

以前まではWindows環境へのRedmineのインストールと言えばBitnamiが主流でした。しかし、BitnamiがRedmine Windowsインストーラーの提供を終了してしまったため、簡易的なインストールができなくなりました。そのため、今回はWindows環境へのRedmineインストール手順をなるべく簡潔にまとめました。ご参考になれば幸いです。

なお、本記事で利用した環境やインストーラーの各バージョンは以下の通りです。

必要なモジュールのインストール

Rubyのインストール

まず以下のURLを参照の上、インストールしたいRedmineバージョンがサポートするRubyバージョンを選択してください。

https://redmine.jp/tech_note/supported-rubies/

以下のリンクから、インストーラーをダウンロードし、インストーラーに従いインストールします。

https://rubyinstaller.org/downloads/

例：Ruby+Devkit X.X.X-X (x64)

インストール中に表示される以下のオプションについては双方にチェックを入れるようにしてください。

インストール画面の最後のチェックを入れた状態で、Finishボタンを押します。

プロンプトが起動しますので以下のように「1, 2, 3」と入力してエンターキーを押し関連するパッケージのインストールを行ってください。

PostgreSQLのインストール

以下のリンクからPostgreSQLをダウンロードし、インストーラーに従いインストールします。

https://www.enterprisedb.com/downloads/postgres-postgresql-downloads

インストール中に表示される以下のオプションについては、必要な場合を除いて「Stack Builder」のチェックを外しておきます。

スーパーユーザーのパスワードを設定します。後ほどpsqlシェルを起動する際にここで設定したパスワードの入力を求められますので忘れないようにしてください。

Redmineの入手/展開

以下のリンクからRedmineをダウンロードし、任意のパスに展開します。

https://www.redmine.org/projects/redmine/wiki/Download

例：C:\Redmine

以降このパスについては <Redmineインストールパス> と記載します。

Redmineのインストールおよび設定

1. DBとDBユーザー作成

Windowsのアプリケーションで「SQL Shell（psql）」を起動します。その際、パスワードを確認されるのでPostgreSQLをインストール時に設定したパスワードを入力します。

ログイン後は、以下のコマンドを実行します。

<Redmineインストールパス>/config/database.example.ymlをコピーして、database.ymlを作成します。手順1で設定したパスワードに合わせて修正します。

以下が修正例です。

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "password"
  encoding: utf8

3. Bundlerのインストール

コマンドプロンプトを起動し<Redmineインストールパス>へ移動します。以下のコマンドを実行します。

以降の手順でもコマンドプロンプトを利用しますので、コマンド実行後も起動したままにしてください。

4. Gemfile.localの設定

<Redmineインストールパス>に「Gemfile.local」ファイルを作成し以下を記載します。

gem "puma"

5. configファイルの作成

<Redmineインストールパス>に「.bundle」ディレクトリを作成し、その中に「config」ファイルを作成します。

6. configファイルに設定を追加

コマンドプロンプトから以下のコマンドを実行してconfigファイルに設定を追加します。

7. bundle installの実行

コマンドプロンプトから以下のコマンドを実行します。

8. 秘密鍵の生成

コマンドプロンプトから以下のコマンドを実行します。

9. データベースのマイグレーション

コマンドプロンプトから以下のコマンドを実行します。

Redmineの起動確認

Redmineの起動

以下のコマンドを実行し、Redmineを起動します。

その後、RedmineのURLにアクセスし起動していることを確認ください。

例：http://localhost:3000

Windowsのサービスとして登録する

RedmineをWindowsのサービスとして登録するには様々な方法がありますが、ここでは一例として WinSW（Windows Service Wrapper） を利用する方法ご紹介します。

1. 管理用フォルダの作成

<Redmineインストールパス>に「service」フォルダを作成します。

2. WinSWの取得

以下のURLから「WinSW-x64.exe」をダウンロードします。

https://github.com/winsw/winsw/releases

ダウンロードしたファイル名を「Redmine.exe」に変更し、<Redmineインストールパス>\service に保存します。

3. 構成ファイルを作成

<Redmineインストールパス>\serviceに「Redmine.xml」ファイルを作成します。

以下が設定例です。RubyやRedmineのインストールパスは実際の環境に合わせて修正ください。

<service>
  <id>Redmine</id>
  <name>Redmine</name>
  <description>Redmine as Windows Service</description>

  <executable>cmd</executable>

  <arguments>/c "C:\Ruby33-x64\bin\bundle.bat exec puma -p 3000"</arguments>
  <workingdirectory>C:\Redmine</workingdirectory>

  <env name="RAILS_ENV" value="production" />
  <env name="GEM_HOME" value="C:\Ruby33-x64\lib\ruby\gems\3.3.0" />
  <env name="GEM_PATH" value="C:\Ruby33-x64\lib\ruby\gems\3.3.0" />

  <stoptimeout>30000</stoptimeout>
  <stopparentprocessfirst>true</stopparentprocessfirst>

  <logmode>rotate</logmode>
  <logpath>C:\Redmine\log</logpath>
  <onfailure action="restart" delay="10 sec"/>
</service>

4. サービスのインストールと起動

コマンドプロンプトを起動し<Redmineインストールパス>\serviceへ移動します。以下のコマンドを実行します。

パフォーマンスに関する懸念

現在のRedmineではアプリケーションサーバーとしてpumaを利用するのがデフォルトとなっております。しかしpumaはWindows環境ではマルチプロセス（workers）に対応しておりません。そのため、重い処理に対応できないことが懸念されます。こうしたパフォーマンスの懸念事項も踏まえてWindows環境へのインストールをご検討されている場合は、一度弊社までご相談ください。

まとめ

RedmineをWindows環境へインストールする方法についてご紹介しました。サーバーPCとしてWindows OSしか利用できないケースもあると思いますので、今回の記事が参考になれば幸いです。

なお、テクマトリックスでは、環境構築やメンテナンスをせずにいつでも利用できるRedmineのクラウドサービスを提供しています。チケット数無制限、100ユーザーまで月額7,000円でご利用いただけます。30日間の無料トライアルもありますので、ぜひご検討ください！

また、Redmineの環境構築支援サービスも行っています。お客様の環境へのRedmineのインストール作業や、既存のRedmineのバージョンアップ作業を実施します。詳しくは、以下のボタンよりご確認ください！

Redmineクラウドサービスの詳細を見る

Redmineクラウドサービスの詳細を見る