More than 1 year has passed since last update.

@RottenOrange

Windows10環境へRedmineをインストール

Posted at 2023-04-17

Windows10環境へRedmineをインストールした作業メモ

どうやってインストールしたか忘れているだろう3年後の自分へ向けて、備忘録としてRedmineをインストールする手順をここに残しておく。
（※1年後も覚えているか怪しいが）

そもそも「Redmine」とは

Redmineは、プロジェクト管理に使用されるオープンソースのWebアプリケーションで、Ruby on Railsフレームワークを使用して作成されている。

公式サイト¹はこちら ↓

作業内容はインストールガイド²や他の方がQiita³に投稿した記事を参考にした ↓

導入環境・ソフトウェア

OS・ソフトウェア	バージョン等
Windows	Windows 10 Pro 64bit
Redmine	Redmine 5.0
Ruby	Ruby 3.0
PostgreSQL	PostgreSQL 15

インストールガイドで導入するソフトウェアに必要なバージョンが違っていると、後続の手順でうまくいかないので必ず確認すること（経験に基づく注意喚起）

事前準備

インストールガイドには記載はないが、事前にインストールしておかないといけないものをインストールしておく。

Rubyのインストール

公式サイトからインストーラーをダウンロードする。
今回インストールするRedmineはRuby on railsを使用するのでDevkitがついているインストーラーをダウンロードする。
PostgreSQLのインストール

ここを参照。（PostgreSQLのインストールについては別出しで記載）
webrickのインストール（※Rubyインストール後に実行）
実行コマンド
```
gem install webrick
```
ImageMagickのインストール（※Rubyインストール後に実行）

ImageMagickのダウンロードサイトから「ImageMagick-7.1.1-7-Q16-HDRI-x64-dll.exe」をダウンロードする
ダウンロードしたファイルを実行する。基本的にはデフォルトのまま設定するが、下の画面の時は、「Install development headers and libraries for C and C++」のチェックを忘れないようにする。
環境変数の設定

変数名	変数値	補足
Path	C:\Program Files\ImageMagick	インストールしたときに設定したディレクトリを設定する

下記コマンドの実行

gem install rmagick

Redmineのインストール

Redmineのインストールは公式のインストールガイドに従って実施する。

1. Redmineインストール

下記サイトから「redmine-5.0.5.zip」をダウンロードし、解凍する。解凍したフォルダは、Cドライブ直下（C:\redmine-5.0.5）に配置する。

2. 空のデータベースとユーザを作成

今回はPostgreSQLにデータベースをユーザを作成する。

psqlを起動
下記コマンドを実行

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

※パスワードの箇所（PASSWORD 'my_password'）は、適宜書き換えて実行

3. データベース接続のための設定

config配下にある「database.yml.example」をコピーし、「database.yml」を作成する。
「database.yml」に下記内容を設定

production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: "my_password" ※適宜書き換え
  encoding: utf8

4. 依存関係にあるソフトウェアのインストール

実行コマンド：

bundle config set --local without 'development test' 
bundle install --without development test
bundle add webrick rmagick

5. セッションストア秘密鍵の生成

実行コマンド：

bundle exec rake generate_secret_token

6. データベーススキーマ等の作成

環境変数の設定

変数名	変数値	補足
RUBY_DLL_PATH	C:\Program Files\PostgreSQL\15\bin	PostgreSQLをインストールしたディレクトリのパスを設定

下記コマンドを実行

set RAILS_ENV=production
bundle exec rake db:migrate

※環境変数の設定を行っておかないとエラーになるので注意。このページ⁴を参照して解決

7. デフォルトデータセット

下記コマンドを実行

set RAILS_ENV=production
set REDMINE_LANG=ja
bundle exec rake redmine:load_default_data

8. ファイルシステムのアクセス権の設定

Windows版ではこの作業はスキップ

9. インストールの確認

公式のコマンドではうまく実行できなかったので、参考にしたページ³のコマンドを実行

bundle exec rails s -e production

10. アプリケーションにログイン

下記URLにアクセスし、ログイン画面を開く
http://localhost:3000/

【ログイン画面】

項目	設定値
ユーザID	admin
パスワード	admin

上表のユーザでログインする。その後、パスワード変更を求められるので、適宜、設定する。

パスワード変更後、個人設定画面に遷移する。

ここまでRedmineのインストールは完了。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up