LinuxにRedmineをインストールする手順を分かりやすく解説！

はじめに

Redmine（レッドマイン）は、オープンソースで提供されている高機能なタスク管理ツールです。
プロジェクトの進捗管理や、チケットによる課題管理がしやすく、個人利用からチームでの運用まで幅広く活用されています。

本記事では、Linux環境にRedmineをインストールする方法を、わかりやすく解説していきます。
Redmineの魅力を体感するためには、まずは自分の環境にインストールしてみるのが一番です。
「Redmineを使ってみたいけど、インストール手順が分からない」という方に向けて、シンプルに手順だけに特化した内容となっています。

この記事を読み進めることで、RedmineをLinux上で動かすまでの一連の流れが把握でき、自分の用途に合わせた活用への第一歩を踏み出せます。

必要な環境とインストールの流れ

RedmineをLinuxにインストールする前に、必要な環境と準備するものを確認しておきましょう。

必要な環境

• OS：Ubuntu（またはDebian系のディストリビューション）
• データベース（MySQL/MariaDB/PostgreSQL）
• Ruby（RedmineはRubyで動作します）
• Webサーバー（Apache または Nginx）

※この記事ではRedmineのインストールまでを解説します。Webサーバーを通じて公開する方法やセキュリティ設定については、別の記事で詳しく紹介します

既にシステムにRubyがインストールされており、Redmineの推奨バージョンと異なる場合や、環境を汚したくない場合には、Dockerを使ったインストールも可能です
Dockerを使えば、依存関係やバージョン違いに悩まず、簡単にRedmineを導入できます

インストールの流れ

このあと、以下の手順でRedmineをインストールしていきます。

Ubuntu22.0.4にてインストールと動作することを確認（2025年4月29日 ）

データベースのインストールと準備

Redmineのインストールには、あらかじめデータベース（MariaDBなど）を準備しておく必要があります。
まだインストールしていない方は、以下の記事を参考にして、MariaDBの導入と初期設定を済ませてください。

あわせて読みたい

タノコン

UbuntuにMariaDBをインストールする方法、クライアント導入と初期設定まで解説 | タノコン

必要なパッケージのインストール

※以降では、MariaDBがインストール済みであることを前提に進めます。

Redmineのインストールに必要なパッケージを一括でインストールします。

sudo apt install -y build-essential libssl-dev libreadline-dev zlib1g-dev libmysqlclient-dev libpq-dev
sudo apt install -y git curl libxml2-dev libxslt1-dev imagemagick libmagickwand-dev

Redmine用のデータベースとユーザーを作成

MariaDBにログインします。

sudo mysql -u root -p

以下のコマンドでRedmine用のデータベースとユーザーを作成します。

CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER 'redmine_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Ruby環境の構築

RedmineはRubyで動作するため、まずは適切なバージョンのRubyをインストールする必要があります。
ここでは、システムに影響を与えず、安全にRubyを管理できるrbenvを使ったインストール方法を紹介します。

Redmineのバージョンに合わせたRubyのバージョンを確認する

Redmineはバージョンごとに対応するRubyのバージョンが異なります。
まずは、インストールしたいRedmineのバージョンに対応したRubyを確認してください。

この記事では、Redmine 6.0.5をインストールするのを想定しています
対応するRubyバージョンは 3.1 / 3.2 / 3.3 です
この記事では、Ruby 3.3 を使用して説明します

Rubyのインストール

Ruby環境の構築方法については、別記事「UbuntuにRuby環境を構築する方法」で詳しく解説しています。ここでは、その記事をもとにRedmineに必要なバージョンをインストールしていきます。
今回インストールするRubyバージョンは、Ruby 3.3です。

あわせて読みたい

タノコン

UbuntuにRuby環境を構築する方法 rbenvとruby-buildで安全に導入！ | タノコン

Redmineのダウンロードと展開

データベースとRubyの準備ができたら、いよいよRedmine本体のインストールに進みます。
ここでは、Redmineの最新版をダウンロードし、必要な設定を行っていきます。

WEBサーバーをインストールしていない方は、以下の記事を参考にインストールしてください。

あわせて読みたい

タノコン

【初心者向け】UbuntuにApacheをインストールしてWebサーバーを構築する手順を解説 | タノコン

1. Redmineの最新版をダウンロード

まず、ダウンロードするディレクトリへ移動します。このディレクトリは、Webサーバー（ApacheやNginx）の公開ディレクトリとしてよく使われます。

cd /var/www

Redmineの公式サイトから最新版を確認し、ダウンロードします。

sudo wget https://www.redmine.org/releases/redmine-6.0.5.tar.gz

最新バージョンは、こちらで確認してください
　※ 2025年4月時点では、redmine-6.0.5 でした

ダウンロードしたファイルを展開

ダウンロードしたファイルを展開し、リネームします。

sudo tar -xvzf redmine-6.0.5.tar.gz
sudo mv redmine-6.0.5 redmine

必要な権限の設定

Redmineのディレクトリに適切な権限を設定します。

sudo chown -R www-data:www-data /var/www/redmine

データベース設定ファイルの作成

Redmineのディレクトリ内にある設定ファイルをコピーし、自分の環境に合わせて編集します。

cd /var/www/redmine/config
sudo cp database.yml.example database.yml
sudo nano database.yml

開かれた、database.ymlのproduction:セクションを以下の様に編集します。

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine_user
  password: "your_password"
  encoding: utf8mb4

「Redmine用のデータベースとユーザーを作成」項目で作成したredmine_user とyour_passwordを設定します

production:セクション内で上記以外の項目はコメント化してください

Redmineの初期設定

Redmineのインストールが完了したら、次は初期設定を行い、実際にRedmineが動作するように準備を整えていきます。

依存パッケージのインストール

Redmineを動作させるためには、必要なパッケージやGemをインストールする必要があります。

依存パッケージのインストール

sudo apt install -y libmysqlclient-dev imagemagick libmagickwand-dev

BundlerでGemをインストール

cd /var/www/redmine
gem install bundler

pumaをインストール

gem install puma

pumaは、Ruby on Rails でよく使われるアプリケーションサーバーです。RedmineのようなRailsアプリを一時的に起動して確認するのに便利です
本番環境では、ApacheやNginxに、Passenger などのアプリケーションサーバーを組み込んで運用するのが一般的です。ここでは、Redmineを一時的に起動するため、pumaを導入します

Gemファイルに、Gem 'puma'を追記

cd /var/www/redmine
sudo nano Gemfile

権限をログインユーザーに変更

sudo chown -R $USER:$USER /var/www/redmine

bundlerは、Linuxにログインしているユーザーの権限でインストールしています。redmineのパーミッションがwww-dataになっているため、次の本番環境向けに最適化するコマンドが実行できません。そのため、Redmineディレクトリ以下の権限を、一旦ログインユーザーに切り替えます
上記コマンドの、$USER:$USERは、ログインユーザー名に置き換えてください

本番環境向けに最適化

bundle install --without development test

secret_key_base の生成と設定

RedmineのようなRailsアプリを productionモードで起動 するには、セキュリティのために secret_key_base を設定する必要があります。

秘密鍵を生成する

RAILS_ENV=production bundle exec rake generate_secret_token

Redmine のディレクトリ /config/initializers/secret_token.rb に、secret が書き込まれればOKです。

Redmine用のデータベースを初期化

データベースに「Redmineが動作するために必要なテーブルや初期構造」を作成します。

RAILS_ENV=production bundle exec rake db:migrate

もし、ここでエラーが発生する場合、こちらのdatabase.ymlファイルの編集内容が間違っている可能性が高いです
特にパスワードに間違いがないか確認してください。

Redmineを起動して確認（簡易起動）

Redmineが正しくインストールされたか、Railsの簡易サーバーを使って動作確認を行います。

RAILS_ENV=production bundle exec rails server -b 0.0.0.0 -p 3000

この方法は、Ruby on Railsの標準機能であるWEBrickサーバーを使って、Redmineを一時的に動かすものです
本番環境向けではありませんが、インストール直後の動作確認には十分です
RedmineはRailsアプリケーションのため、Ruby → Rails → Redmine の流れで起動しています

もしアクセスできない場合は、ファイヤウォールを確認してみてください
sudo ufw status
もし、ポート3000が表示されていない場合は、以下のコマンドで追加してください
sudo ufw allow 3000

Redmineの初期画面は↓。

最後に、権限をwww-dataに戻す

今回の動作確認は、インストール直後の動作を確認するためだけの方法です。実際の運用である本番環境では、パーミッションがwww-dataである必要があります。

sudo chown -R www-data:www-data /var/www/redmine

まとめ Redmineのインストールはこれで完了！

今回は、Linux環境にRedmineをインストールし、簡易的な動作確認までを行いました。
Rubyのインストールから、データベースの準備、Redmineの展開・設定まで、しっかりと手順を追ってきましたね。

今回のまとめです。