Windows 11 (24H2) に Redmine 6.0.6 をインストールしたメモ（Ruby 3.3 + PostgreSQL 17） - PokuG stdio.h

昔からちょっとしたタスク管理やチケット管理には Trac Lightning を使っていました。
インストールが簡単で、Windows 上でも気軽に動かせるのが魅力だったのですが、気づけば開発が止まってしまい、最新の環境では扱いづらい環境に。。。

「そろそろ代替ツールを探さないと」と思って調べてみると、同じようにオープンソースで開発が続いている Redmine にたどり着きました。
チケット駆動の考え方も Trac に近く、今でも活発に更新されているのがおそらく安心。

そこで今回は、まずはお試しということで Windows 11 上に Redmine 6.0.6 を構築してみました。
Ruby 3.3 + PostgreSQL 17 の環境でどのくらいすんなり動くのか、その手順をまとめてみます。

本記事はRedmine 6.0.6ですが、以下記事はRedmine 6.1.0の最新記事になります。
pokug.net

1. 参考サイト
- Redmine.JP
- Lychee Redmine
2. 必要なもの（ダウンロード先）
3. rubyのインストール
4. postgresqlのインストール
5. Redmineの配置
- 5.1 アーカイブ解凍
- 5.2 ディレクトリの配置
6. データベース準備
7. Redmineの設定
8. Bundler でセットアップ
9. 初期化設定
10. 起動と接続テスト
11. おわり

1. 参考サイト

インストールについて以下サイトを参考させていただきました。

Redmine.JP

日本語で詳しいインストール手順やTipsがまとまったコミュニティサイトです。
インストール — Redmine.JP

Lychee Redmine

Redmine を拡張するプラグインとサポートサービスを提供する商用サイトみたいです。
具体的なインストール手順が乗っています。
Windows環境へのRedmineのインストール（PostgreSQL版） » Lychee Redmine

2. 必要なもの（ダウンロード先）

今回の環境構築で使用したソフトウェアとダウンロード先は以下の通りです。

ソフト / OS	バージョン	備考	ダウンロード先
Windows 11	24H2	-	-
Redmine	6.0.6	アーカイブ形式 (.zip)	ダウンロード
RubyInstaller with Devkit	3.3.9 (x64)	Devkit 同梱版を使用	ダウンロード
PostgreSQL	17.6(Windows x64)	-	ダウンロード

今回使用したファイルは以下の通りです：
・Redmine：redmine-6.0.6.zip
・RubyInstaller：rubyinstaller-devkit-3.3.9-1-x64.exe
　（※必ずDevkit付きを選びましょう）
・PostgreSQL：postgresql-17.6-1-windows-x64.exe

3. rubyのインストール

Redmine 6 は Ruby 3.3 系に対応しています。
今回は RubyInstaller 3.3.9 (x64, Devkit付き) を使用しました。

3.1 インストーラの起動

ダウンロードしたインストーラをダブルクリックして起動します。

3.2 セットアップモード選択

「Install for all users」を選んで進めます。

3.3 ライセンス承諾

ライセンスに同意して「Next」をクリック。

3.4 インストール先フォルダとオプション

インストール先はデフォルトのまま C:\Ruby33-x64 を選択。
チェック項目はデフォルトのままです。

3.5 コンポーネント選択

特に変更せず、そのまま進めます。

3.6 インストールの実行

インストールが開始されます。

3.7 セットアップ終了

インストールが完了すると「Run 'ridk install' to setup MSYS2...」のチェックボックスが表示されます。
このチェックはオンにしたまま終了します。

3.8 MSYS2のインストール

MSYS2 development toolchainをインストールするので、3と入力します。
なお、3を入力すると、1もインストールされるらしいです。

3.9 インストール終了

MSYS2 のインストールが終われば、Ruby + Devkit のセットアップは完了です。
Enterを押します。

4. postgresqlのインストール

Redmine のデータベースには PostgreSQL を使用します。
今回は PostgreSQL 17.6 (Windows x64 インストーラ) を利用しました。

4.1 起動

ダウンロードしたファイルを実行してセットアップを開始します。

4.2 セットアップ開始

「Next」をクリックして進めます。

4.3 インストール先フォルダ

デフォルトの C:\Program Files\PostgreSQL\17 を指定しました。

4.4 コンポーネント選択

「PostgreSQL Server」、「pgAdmin 4」など、デフォルトのままチェックを入れて進めます。

4.5 データベース保存先

デフォルトのまま（C:\Program Files\PostgreSQL\17\data）で進めました。

4.6 管理者パスワード設定

postgres ユーザーのパスワードを設定します。
（後で DB作成時に使うので必ず控えておきます）
今回は「admin」でいきます。

4.7 ポート番号指定

デフォルトの 5432 を指定しました。

4.8 アドバンスオプション

ロケールなどの設定。基本的にデフォルトのまま進めて問題ありません。

4.9 サマリー

設定内容が表示されるので確認し、「Next」を押します。

4.10 インストール実行

「Next」でインストールを開始します。

4.11 インストール

必要なコンポーネントが展開され、PostgreSQL がセットアップされます。

4.12 インストール終了

インストール完了画面が表示されれば終了です。
今回はtack Builderは入れないのでチェックを外し、「Finish」を押します。

5. Redmineの配置

続いて Redmine 本体を配置します。
今回は公式サイトから Redmine 6.0.6 を取得しました。

5.1 アーカイブ解凍

ダウンロードした redmine-6.0.6.zip を展開します。

5.2 ディレクトリの配置

展開してできたフォルダを「redmine」にリネームし、C:\ 直下にコピーします。
最終的なディレクトリ構成は以下の通りです：

C:\Redmine\
  ├─ app
  ├─ bin
  ├─ config
  ├─ db
  ├─ files
  ├─ lib
  └─ ...

6. データベース準備

Redmine 用のデータベースとユーザーを作成します。
PostgreSQL インストール時に作られた postgres ユーザーを使って作業します。

6.1 psqlの起動

スタートメニューから SQL Shell (psql) を起動します。
「スタートアイコン」→「すべて」→「PostgreSQL 17」→「SQL Shell(psql)」

6.2 ログイン

Server、Database、Port、Username、Client EncodingまではすべてEnterを押します。
最後に postgres ユーザーのパスワードを入力します。
今回は手順4.6で設定した「admin」を入力します。

6.3 データベースユーザーの作成

Redmine 用のユーザー（redmine）を作成します。

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'redminepass' NOINHERIT VALID UNTIL 'infinity';

DBのredmineユーザーのパスワードは「redminepass」とします。

6.4 データベース作成

Redmine 用のデータベースを作成します。

CREATE DATABASE redmine WITH ENCODING='UTF8' LC_COLLATE='ja_JP.UTF-8' LC_CTYPE='ja_JP.UTF-8' TEMPLATE template0 OWNER redmine;

7. Redmineの設定

作成したデータベースに接続できるように、Redmine 側の設定を行います。
主に config/database.yml と .bundle/config を編集します。

7.1 config/database.yml の編集

C:\Redmine\config\以下にRedmine の初期状態では 「database.example.yml」 というサンプルファイルが入っています。
これをコピーまたはリネームして「database.yml」を作成し、編集します。
編集後の database.yml は以下のように設定します：

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

※編集前の「database.example.yml」に色々書いてありますが、今回は上記の7行だけ書きます（他は消す）

7.2 .bundle/config の作成

「C:\Redmine」に「.bundle」ディレクトリを作成し、その中に「config」ファイルを作成し以下を記載します。

BUNDLE_PATH: "vendor/bundle"
BUNDLE_BUILD__PG: "--with-pg-config='C:/Program Files/PostgreSQL/17/bin/pg_config.exe'"
BUNDLE_WITHOUT: "development:test"

※PostgreSQL を別の場所にインストールした場合は、pg_config.exe のパスを環境に合わせて修正してください。

7.3 Gemfile.local の作成

C:\Redmine以下に「Gemfile.local」ファイルを作成し以下を記載します。

 gem 'puma'

※なお、Puma は Rails/Redmine の標準的なアプリケーションサーバーらしいです

8. Bundler でセットアップ

Redmine が必要とする Ruby ライブラリ（gem）をまとめてインストールします。
まずは Bundler 本体を入れて、その後に bundle install で依存ライブラリを一括インストールします。

8.1 Power Shellを管理者権限で起動

Power Shellを管理者権限で起動します。
本来は管理者権限で起動の必要はないような気がしますが、管理者でないとBundler のインストールでエラーが出たのでこうしています。

8.2 C:\Redmineへ移動する

C:\Redmineへ移動します。

8.3 Bundler のインストール

以下を実行します。

gem install bundler

何か警告が出ますが無視します。

8.4 依存ライブラリの一括インストール（bundle install）

続いて、Redmine の Gemfile（およびGemfile.local）に基づいて必要なライブラリをインストールします。
※Redmine の動作に必要な gem（rails, pg など）が vendor/bundle 配下にまとめてインストールされます。

bundle install

上の行に、出ているメッセージは注意喚起だけで、今の Redmine 6.0 構成ではそのままで問題なさそうなので、このまま続けます。

9. 初期化設定

Bundler で必要なライブラリを入れ終えたら、Redmine を動かすための初期設定を行います。

9.1 秘密鍵の生成

セッション管理などに必要な秘密鍵を生成します。

bundle exec rake generate_secret_token

もし、ここで「PostgreSQL の DLL が見つからないときは」以下を実行し、再度、秘密鍵を生成を実行します。
通常はPostgreSQLをインストールしたときに、以下パスはインストーラーが通しているので必要ないと思います。

$env:RUBY_DLL_PATH="C:\Program Files\PostgreSQL\17\bin"

9.2 データベースマイグレーション

データベースに必要なテーブルを作成します。
Redmine のチケット管理やユーザー情報などを保存するテーブルが DB に作成されます。

$env:RAILS_ENV="production"
bundle exec rake db:migrate

DB作成終了です。

9.3 デフォルトデータ投入

プロジェクト設定やロールなどの初期データを登録します。

$env:RAILS_ENV = "production"
$env:REDMINE_LANG = "ja"
bundle exec rake redmine:load_default_data

言語は ja を指定することで日本語の初期データが入ります。

10. 起動と接続テスト

ここまでで Redmine の準備が整いました。
最後にアプリケーションサーバーを起動し、ブラウザからアクセスできるか確認します。

10.1 サーバーの起動

PowerShell で Redmine ディレクトリ（C:\Redmine）に移動し、以下を実行します。

bundle exec rails server -e production -b 0.0.0.0 -p 3000

10.2 ブラウザからアクセス

ブラウザを開き、以下の URL にアクセスします。
・自分の PC から → http://localhost:3000
・LAN 内の別 PC から → http://＜Redmine PCのIPアドレス＞:3000

10.3 初期ログイン

初期アカウントは以下の通りです。
・ユーザー名：admin
・パスワード：admin
初回ログイン時にパスワード変更が求められます。

11. おわり

・Windows 11 (24H2) 上に Redmine 6.0.6 を構築しました。
・Ruby は RubyInstaller 3.3.9 (Devkit付き)、DB は PostgreSQL 17.6 を使用しました。
・セットアップの流れは以下の通りです。
　　1. Ruby のインストール
　　2. PostgreSQL のインストール
　　3. Redmine の配置
　　4. DBユーザー・DB作成
　　5. Redmine 設定ファイル編集
　　6. Bundler で依存ライブラリ導入
　　7. 初期化処理（秘密鍵生成、DBマイグレーション、デフォルトデータ投入）
　　8. サーバー起動と接続テスト
　　9. LAN 内の複数 PC から http://:3000 でアクセス可能

思った以上にすんなり起動しました。
ネットを調べると Windows 11 + Redmine 6.x の事例はほとんど見つからなかったのですが、実際には Ruby 3.3 + PostgreSQL 17 でも問題なく動作しているように見えます。

今回は「とりあえず使う」を前提でシンプルに構築しましたが、
本格運用する場合は以下も検討すると良いと思います。
・Redmine への同時接続数の上限を上げる
・Apache を導入して Redmine をサブ URL 及び 80 番ポートで公開
・Windows サービス化して常時稼働させる
・定期的な DB・files/ フォルダのバックアップ