インストールガイド · 2 min read · Dec 21, 2025

Ubuntu 22.04にRedmineプロジェクト管理ツールをインストールする方法

Redmineは、無料でオープンソースのプロジェクト管理および課題追跡ツールです。主にRuby on Railsで書かれたWebベースのアプリケーションソフトウェアです。クロスプラットフォームで、複数のデータベースと複数の言語をサポートしています。

Redmineは柔軟で、小規模、中規模、大規模の組織やプロジェクトに使用できます。複数のプロジェクトを作成および管理でき、各プロジェクトには独自のWiki、フォーラム、課題追跡などがあります。また、組織のニーズに基づいてカスタムロールを作成することもでき、その他多くの機能があります。

RedmineはGNU GPL v2ライセンスの下でリリースされており、Linux、Windows、macOSなどの任意のオペレーティングシステムにインストールできます。PostgreSQL、MySQL、SQLite（デフォルト）など、さまざまなタイプのデータベースをサポートしています。

このガイドでは、Ubuntu 22.04サーバーにApache2ウェブサーバーとMySQLサーバーを使用してRedmineをインストールします。また、SSL証明書でRedmineのインストールを保護します。

前提条件

このチュートリアルには、以下の要件が必要です：

  • Ubuntu 22.04サーバー - この例では、ホスト名redmine-serverのUbuntuサーバーを使用します。
  • sudoルート権限を持つ非ルートユーザー - ただし、ルートユーザーを使用することもできます。
  • サーバーのIPアドレスを指すドメイン名 - 本番環境では、ドメイン名がサーバーのIPアドレスを指していることを確認する必要があります。

すべてが整ったら、Redmineのインストールの最初のステップに進むことができます。

依存関係のインストール

Redmineは、主にRubyおよびRuby on Rails（RoR）で書かれたオープンソースのプロジェクト管理および課題追跡ツールです。Redmineをインストールするには、まずRubyをインストールし、その後、ウェブサーバーApache2やMySQLサーバーを使用して他の依存関係をインストールする必要があります。

この例では、Apache2ウェブサーバーとMySQLサーバーでRedmineを実行します。

パッケージのインストールを開始する前に、以下のaptコマンドを実行してUbuntuパッケージインデックスを更新およびリフレッシュします。

sudo apt update

リポジトリが更新されたら、以下のaptコマンドを使用していくつかのパッケージ依存関係をインストールします。

このコマンドを使用すると、Apache2ウェブサーバーがインストールされ、その後、Apache2の下でRoRアプリケーションを実行するために使用されるlinapache2-mod-passengerがインストールされます。また、Rubyパッケージもインストールします。

sudo apt install apache2 ruby ruby-dev build-essential libapache2-mod-passenger libmysqlclient-dev

インストールの確認を求められたら、yと入力してENTERを押して続行します。

install dependencies

Apache2とRubyがインストールされたら、以下のコマンドを実行してMySQLサーバーをインストールします。RedmineはPostgreSQL、MySQL/MariaDB、SQLiteなど、複数のRDBMSをサポートしています。この例ではMySQLサーバーを使用します。

sudo apt install mysql-server

インストールの確認を求められたら、yと入力してENTERを押して続行します。

install mysql

Redmineのインストールには、Ubuntuサーバーにbundlerをインストールする必要があります。bundlerは、Ruby Gemsパッケージを管理するために使用されるコマンドラインです。

以下のコマンドを実行して、システムにbundlerをインストールします。

sudo gem install bundler

bundlerがインストールされると、以下のような出力が表示されます。

install bundler

最後に、以下のsystemctlコマンドを使用してApache2とMySQLサービスを確認します。これにより、Apache2とMariaDBサービスの両方が実行され、有効になっていることが確認されます。

Apache2サービスを確認します。

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

以下のように、Apache2サービスが有効であり、システム起動時に自動的に実行されることが確認できます。また、サービスの現在のステータスは実行中です。

check apache2

MySQLサービスを確認します。

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

以下のような出力が表示されます - MySQLサービスは有効であり、起動時に自動的に実行されます。また、MySQLサービスの現在のステータスは実行中です。

check mysql

MySQLサーバーの設定

Apache2とMySQLサーバーがインストールされたら、MySQLのrootパスワードを設定し、mysql_secure_installationを使用してデプロイを保護します。その後、Redmine用の新しいMySQLデータベースとユーザーを作成します。

以下のmysqlコマンドを使用してMySQLにログインします。

sudo mysql

次に、以下のクエリを使用してMySQLのrootパスワードを変更します。必ず自分のパスワードに変更してください。その後、quitと入力してMySQLシェルから退出します。

ALTER USER root@localhost IDENTIFIED WITH mysql_native_password BY 'password';  
quit

change root password

次に、以下のコマンドを実行してMySQLサーバーのデプロイを保護します。

sudo mysql_secure_installation

MySQLのrootパスワードを求められたら、正しいパスワードを入力します。

次に、rootユーザーのリモートログインを無効にする、匿名ユーザーを削除する、デフォルトデータベースのテストを削除する、すべてのテーブルの権限を再読み込みするなど、他のMySQL設定を求められます。これらのMySQLサーバー設定すべてに対して、設定を確認するためにYと入力します。

MySQLのデプロイを保護した後は、Redmine用の新しいデータベースとユーザーを設定する時間です。

以下のmysqlコマンドを使用してMySQLシェルにログインします。MySQLのrootパスワードを求められたら、正しいパスワードを入力してENTERを押します。

sudo mysql -u root -p

次に、以下のクエリを実行してRedmine用の新しいMySQLデータベースとユーザーを作成します。この例では、新しいデータベースとユーザーredmineを作成し、パスワードを’ secretPassword ‘に設定します。データベースのパスワードは自分のパスワードに置き換えることができます。

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

create db and user

次に、以下のクエリを実行してMySQLユーザーredmineの権限を確認します。MySQLユーザーredmineがデータベースredmineに対する権限を持っていることを確認してください。

SHOW GRANTS FOR redmine@localhost;  
quit

以下のように、MySQLユーザーredmine@localhostがデータベースredmineに対する権限を持っていることが確認できます。

check privileges

最後に、quitと入力してMySQLシェルからログアウトします。

すべての依存関係がインストールされ、MySQLデータベースとユーザーが作成されたので、UbuntuサーバーにRedmineプロジェクト管理ツールをインストールする準備が整いました。

Redmineのインストール

このステップでは、Redmineの最新バージョンをインストールします。この記事執筆時点でのRedmineの最新バージョンはv5.0.2です。

Redmineのソースコードをダウンロードし、データベースを設定し、ビルドを介してRubyの依存関係をインストールし、Redmineの秘密トークンを設定し、データベースをマイグレーションします。

この例では、/opt/redmineディレクトリ内にRedmineをインストールします。

/optディレクトリに移動します。

cd /opt/

次に、以下のwgetコマンドを使用してRedmineのソースコードをダウンロードします。ダウンロードが完了すると、/optディレクトリにredmine-5.0.2.tar.gzファイルが表示されます。

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

次に、以下のコマンドを実行してRedmineのソースコードredmine-5.0.2.tar.gzを抽出し、Redmineディレクトリへの新しいシンボリックリンクを/opt/redmineに作成します。

tar -xvzf redmine-5.0.2.tar.gz  
sudo ln -s redmine-5.0.2 redmine

Redmineのメインインストールディレクトリは/opt/redmineになります。

/opt/redmineディレクトリに移動します。

cd /opt/redmine/

デフォルトのデータベース設定’config/database.yml.example’を’config/database.yml’にコピーします。次に、nanoエディタを使用してデータベース設定ファイル’config/database.yml’を開きます。

cp config/database.yml.example config/database.yml  
nano config/database.yml

copy database config

‘production’セクションで、MySQLデータベースとユーザーの詳細を変更します。Redmine用の正しいデータベースユーザーとパスワードを使用してください。

production:  
  adapter: mysql2  
  database: redmine  
  host: localhost  
  username: redmine  
  password: "secretPassword"   
  # MySQL 5.7.7以前は"utf8"を"utfmb4"の代わりに使用してください  
  encoding: utf8mb4

ファイルを保存し、終了したらエディタを終了します。

次に、以下のbundlerコマンドを実行してRedmineアプリケーションのRuby依存関係をインストールします。

bundle config set --local without 'development test'  
bundle install

以下のような出力が表示されます。

install dependencies

Redmineの依存関係がインストールされたら、以下のコマンドを実行してRedmineの秘密トークンを生成し、データベースをマイグレーションします。

bundle exec rake generate_secret_token  
RAILS_ENV=production bundle exec rake db:migrate

次のスクリーンショットでは、Redmineの秘密トークンが生成され、Redmineデータベースのマイグレーションプロセスが表示されます。

migrate database

最後に、以下のコマンドを使用してRedmineインストールのデフォルトをロードします。言語を選択するように求められたら、enを入力してEnglishを選択します。

RAILS_ENV=production bundle exec rake redmine:load_default_data

Redmineのデフォルトデータがロードされると、「 デフォルトの設定データがロードされました 」という出力メッセージが表示されます。

Redmineがインストールされたので、次にRedmine用のApache2仮想ホストを設定します。

Redmineの仮想ホストの設定

このステップでは、Redmine用の新しいApache2仮想ホスト設定を作成します。サーバーのIPアドレスを指すドメイン名とSSL証明書が生成されていることを確認してください。

以下のコマンドを実行して、Apacheモジュールsslとrewriteを有効にします。

sudo a2enmod ssl rewrite

以下のような出力が表示されます。

enable apache2 modules

次に、nanoエディタを使用して新しいApache2仮想ホスト設定’ /etc/apache2/sites-available/redmine.conf ‘を作成します。

sudo nano /etc/apache2/sites-available/redmine.conf

ファイルに以下の設定を追加します。ドメイン名とSSL証明書のパスを自分の設定に変更してください。

  
    ServerName redmine.howtoforge.local  
    ServerAdmin [email protected]  
    # SSLへのリクエストをリダイレクト  
    Redirect permanent "/" "https://redmine.howtoforge.local/"  
  
  
      
        ServerName redmine.howtoforge.local  
        RailsEnv production  
        DocumentRoot /opt/redmine/public  
        ErrorLog ${APACHE_LOG_DIR}/redmine.howtoforge.local.error.log  
        CustomLog ${APACHE_LOG_DIR}/redmine.howtoforge.local.access.log combined  
        SSLEngine on  
        SSLCertificateFile /etc/letsencrypt/live/redmine.howtoforge.local/fullchain.pem  
        SSLCertificateKeyFile /etc/letsencrypt/live/redmine.howtoforge.local/privkey.pem  
          
            Allow from all  
            Require all granted  
          
   

ファイルを保存し、エディタを終了します。

次に、以下のコマンドを実行して仮想ホストファイル’redmine.conf‘を有効にします。その後、Apache2の設定を確認して、正しい設定が行われていることを確認します。

sudo a2ensite redmine.conf  
sudo apachectl configtest

正しいApache2設定が行われている場合、「 構文OK 」という出力メッセージが表示されます。

setup apache vhost

最後に、以下のsystemctlコマンドを使用してApache2サービスを再起動し、新しい仮想ホストファイルを適用します。

sudo systemctl restart apache2

この時点で、Redmineがインストールされ、仮想ホストが設定されました。ドメイン名を介してRedmineインストールにアクセスできるはずです。

UFWファイアウォールの設定

本番環境では、ファイアウォールをオンにする必要があります。Ubuntuシステムでは、デフォルトのファイアウォールUFE（Uncomplicated Firewall）を使用できます。

次に、UFWルールを追加して、デフォルトのHTTPおよびHTTPSサービスを開放し、Redmineがネットワークの外部からアクセスできるようにします。

以下のufwコマンドを実行して、デフォルトの「 OpenSSH 」アプリケーションプロファイルをUFWに追加します。その後、UFWファイアウォールを開始および有効にします。

sudo ufw allow "OpenSSH"  
sudo ufw enable

確認を求められたら、yと入力してUFWファイアウォールサービスを開始および有効にします。

allow ssh

次に、以下のコマンドを実行して、アプリケーションプロファイル「 Apache Full 」をファイアウォールに追加します。その後、以下のコマンドでUFWのステータスを確認します。

sudo ufw allow "Apache Full"  
sudo ufw status

UFWファイアウォールのステータスがアクティブで、現在有効なアプリケーションプロファイルがOpenSSHおよび「 Apache Full 」であることが確認できます。これにより、デフォルトのSSHポート22およびHTTPおよびHTTPSサービスポート80および443が開放されます。

check ufw

Redmineのインストール

ウェブブラウザを開き、Redmineインストールのドメイン名（例： https://redmine.howtoforge.local/）にアクセスします。

Redmineプロジェクト管理および課題追跡ツールのデフォルトのホームページが表示されます。「 サインイン 」をクリックしてRedmine管理ダッシュボードにログインします。

homepage redmine

デフォルトのRedmine管理ユーザーとパスワード「 admin - admin 」を入力します。

login

ログインすると、Redmineのデフォルトパスワードを変更するように求められます。Redmineインストール用の新しいパスワードを入力し、「 適用 」をクリックします。

change password

最後に、Redmine管理ユーザーの詳細を編集し、「 保存 」をクリックして設定を適用します。これでRedmineの基本設定が完了しました。

change users

新しいプロジェクトを追加するには、「 プロジェクト 」メニューをクリックします。Redmineでプロジェクトを作成、編集、削除できるはずです。

projects list

Redmineに設定を追加したい場合は、「 管理 」メニューをクリックします。これにより、ユーザーを追加したり、グループを設定したり、ロールを定義したり、LDAPなどのサードパーティアプリケーションを介して認証を有効にしたりできます。

administration

結論

このチュートリアルでは、Ubuntu 22.04サーバーにRedmineプロジェクト管理および課題追跡ツールをインストールおよび設定しました。また、Redmine用にMariaDBデータベースとNginxウェブサーバーを設定しました。さらに、SSL証明書でRedmineのインストールを保護しました。

これでRedmineがシステムにインストールされました。LDAP認証の追加や、SVN、Git、MercurialなどのSCMとの統合など、追加の設定を行うことでRedmineのインストールを拡張できます。また、組織や会社に応じてロールを追加することもできます。

Share: X/Twitter LinkedIn
#インストールガイド

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。