コンテンツにスキップ
「プリザンター入門」発売中!

インストーラでプリザンターをUbuntuにインストールする

概要

本手順はインストーラを使用してプリザンターの動作環境を構築する手順です。モジュールの配置やパラメータ設定を手動で行う今までの手順でもインストール可能です。手動インストールの手順は下記を参照してください。

対象 環境・バージョン
OS Ubuntu 24.04
DB PostgreSQL 18、MySQL 8.4のいずれか
Webサーバ nginx 1.24.0
Platform .NET 10
Pleasanter 1.5.0.0以降

注意事項

  1. MySQLはver1.4.9.0以降で使用できます。ver1.4.9.0より前のプリザンターはMySQLに対応していません。
  2. MySQLにおいてWebサーバとDBサーバを分離した構成にする場合は「WebサーバとDBサーバを分離した構成でMySQLを利用できるように設定する(Ver.1.4.18.0以降)」または「WebサーバとDBサーバを分離した構成でMySQLを利用できるように設定する(Ver.1.4.17.1以前)」を参照してください。

制限事項

インストーラを使用したインストールはVer1.5.0.0以降が対象です。Ver1.4.23.3以前をインストールする際は手動インストールの手順を参照してください。

前提条件

  1. あらかじめOSをセットアップしてください。OSのセットアップ方法は記載しません。
  2. 動作環境やスペックについての詳細は「プリザンターの動作環境や推奨スペックが知りたい」を確認してください。
  3. プリザンターを起動するユーザをあらかじめ決めておいてください。手順の中で記載している <プリザンターを起動するユーザ> はこのユーザを指します。
  4. 本手順では.NETを /usr/local/bin にインストールする場合として説明します。同一環境に複数バージョンの.NETが必要などの理由で.NETを異なるディレクトリにインストールする場合は、CodeDefinerの実行時やPleasanterサービス用スクリプトの作成でExecStartに指定するディレクトリをインストール先に合わせて変更してください。

1⃣ .NETのセットアップ

下記のコマンドを実行して、.NETをインストールします。

sudo wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
sudo chmod +x ./dotnet-install.sh
sudo ./dotnet-install.sh -c 10.0 -i /usr/local/bin
dotnet --version

詳細は、Microsoftの公式ページ「スクリプトによるインストール」を参照してください。

dotnetコマンドで特定のファイルに関するエラーが発生する場合

Microsoftの公式ページ「Linux 上の .NET パッケージの混同に関する問題を解決する」を参照してください。

2⃣ データベースのセットアップ

使用するデータベースのタブを選択してください。

  1. 下記のコマンドを実行して、PostgreSQLをインストールします。

    sudo apt install -y curl ca-certificates
    sudo install -d /usr/share/postgresql-common/pgdg
    sudo curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc
    sudo sh -c 'echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
    sudo apt update
    sudo apt -y install postgresql-18
    
  2. 下記のコマンドを実行して、PostgreSQL管理用のOSのユーザ「postgres」にパスワードを設定します。
    パスワードの入力を求められるので、パスワードを入力してください。

    sudo passwd postgres
    
  3. 下記のコマンドを実行して、PostgreSQLにログインします。

    sudo su - postgres
    psql -U postgres
    
  4. 下記のSQLを実行して、PostgreSQLの管理ユーザ「postgres」のパスワードを設定します。
    ここで設定したパスワードは「プリザンターのセットアップ」で使用しますので、忘れないように控えてください。

    alter role postgres with password '<新しいパスワード>';
    
  5. 下記のコマンドを実行して、PostgreSQLからログアウトし、ユーザ「postgres」から抜けます。

    \q
    exit
    
  6. /etc/postgresql/18/main/postgresql.conf を開き、ログ出力の設定を下記のように編集します。

    log_destination = 'stderr'
    logging_collector = on
    log_line_prefix = '[%t]%u %d %p[%l]'
    
  7. 下記のコマンドを実行して、PostgreSQLのサービスを再起動し、自動起動を有効にします。

    sudo systemctl restart postgresql
    sudo systemctl enable postgresql
    
外部からDBへのアクセスを許可する場合
  1. /etc/postgresql/18/main/postgresql.conf の下記の2行のコメントを解除して、下記のように設定します。

    # - Connection Settings -
    listen_addresses = '*'  # what IP address(es) to listen on;
    port = 5432             # (change requires restart)
    
  2. /etc/postgresql/18/main/pg_hba.conf に下記の行を追加します。ADDRESSの欄には、アクセスを許可するIPアドレスの範囲を指定します。

    # TYPE  DATABASE        USER            ADDRESS                 METHOD
    host    all             all             192.168.1.0/24          scram-sha-256
    
  3. 下記のコマンドを実行して、PostgreSQLのサービスを再起動します。

    sudo systemctl restart postgresql
    
  1. 下記のコマンドを実行して、MySQLのAPTリポジトリの設定パッケージをダウンロードし、インストールします。
    コマンドで指定したURLは、MySQLの公式ページ「MySQL APT Repository」のものと同一です。

    sudo wget https://dev.mysql.com/get/mysql-apt-config_0.8.36-1_all.deb
    sudo dpkg -i mysql-apt-config_0.8.36-1_all.deb
    
  2. 「パッケージの設定」画面が表示されます。「MySQL Server & Cluster (Currently selected: mysql-8.4-lts)」と表示されていることを確認し、キーボードで「Ok」を選択して Enter キーを押下してください。

    「パッケージの設定」の画面。選択中の「MySQL Server & Cluster」のバージョンが表示されている

  3. 下記のコマンドを実行して、MySQLのサーバをインストールします。

    sudo apt-get update
    sudo apt-get install mysql-server -y
    
  4. MySQLのrootアカウントのパスワードの設定を求められます。任意のパスワードを入力し、キーボードで〈了解〉を選択して Enter キーを押下してください。
    ここで設定したパスワードは「プリザンターのセットアップ」で使用しますので、忘れないように控えてください。

    MySQL の root アカウントのパスワードを入力する CUI の画面

  5. パスワードの再入力を求められます。同じパスワードを入力し、キーボードで〈了解〉を選択して Enter キーを押下してください。

    MySQL の root アカウントのパスワードを再入力する CUI の画面

  6. 下記のコマンドを実行して、サービスの状態を表示します。

    systemctl status mysql.service
    

    「Active: active (running)」と表示され、サービスが起動していることを確認してください。

    ● mysql.service - MySQL Community Server
         Loaded: loaded (/usr/lib/systemd/system/mysql.service; enabled; preset: enabled)
         Active: active (running) since Sun 2026-11-08 13:19:45 UTC; 7s ago
    
  7. 下記のコマンドを実行して、MySQLのサービスの自動起動を有効にします。

    sudo systemctl enable mysql
    
MySQLのrootアカウントのパスワードを変更する場合

OSまたはMySQLのバージョンによっては、インストール中にrootのパスワードの設定を求められない場合があります。その場合、またはrootのパスワードを変更する場合は、下記の手順を実施してください。

  1. /etc/mysql/mysql.conf.d/mysqld.cnf の [mysqld] 配下に下記の設定を追記します。設定ファイルのパスは、OSまたはMySQLのバージョンにより異なる場合があります。

    [mysqld]
    skip-grant-tables
    
  2. 下記のコマンドを実行して、MySQLのサービスを再起動します。

    sudo systemctl restart mysql
    
  3. 下記のコマンドを実行して、MySQLにrootアカウント(パスワードの指定なし)でログインします。

    mysql -u root
    
  4. 下記のSQLを実行して、MySQLのrootアカウントのパスワードを設定し、ログアウトします。

    flush privileges;
    alter user 'root'@'localhost' identified by '<MySQLのrootアカウントの新しいパスワード>';
    quit;
    
  5. /etc/mysql/mysql.conf.d/mysqld.cnf の [mysqld] 配下に追記した skip-grant-tables を削除します。その際 [mysqld] は削除しないでください。

  6. 下記のコマンドを実行して、MySQLのサービスを再起動します。

    sudo systemctl restart mysql
    
  7. 下記のコマンドを実行して、MySQLにrootアカウントでログインできることを確認し、quit; でログアウトしてください。

    mysql -u root -p
    
エラーログの出力先を変更する場合

MySQLでは標準でエラーログの出力が有効です。既定の出力先を変更しない場合、下記の手順は実施不要です。

  1. /etc/mysql/mysql.conf.d/mysqld.cnf の [mysqld] 配下にある log-error に記載されているログファイルのパスを変更します。設定ファイルのパスは、OSまたはMySQLのバージョンにより異なる場合があります。

    [mysqld]
    log-error=/var/log/mysql/error.log
    
  2. 下記のコマンドを実行して、MySQLのサービスを再起動します。

    sudo systemctl restart mysql
    
外部からDBへのアクセスを許可する場合

WebサーバとDBサーバを分離する場合は、下記のマニュアルの手順を実施し、MySQLのユーザを追加します。分離しない場合は実施不要です。

3⃣ インストーラのインストール

下記のコマンドを実行して、インストーラをインストールします。プリザンター1.5.0.0以降をインストールするには、最新のインストーラを使用してください。プリザンター1.4.23.3以前をインストールする場合は、「プリザンターをUbuntuにインストールする」を参照してください。

dotnet tool install -g Implem.PleasanterSetup
echo 'export PATH="$PATH:$HOME/.dotnet/tools"' >> ~/.bashrc
echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
source ~/.bashrc
ネットワークに接続できない場合
  1. 下記のコマンドを実行して、.nupkgファイルを配置するディレクトリを作成します。本手順では /dotnet-tools を作成する場合として説明します。

    sudo mkdir /dotnet-tools
    
  2. NuGet GalleryのImplem.PleasanterSetupのページを開き、画像の①「Download package」から.nupkgファイルをダウンロードします。

    Implem.PleasanterSetup の NuGet ギャラリーのページ。「Download package」がある

  3. 手順2でダウンロードした.nupkgファイルを /dotnet-tools に配置します。

  4. 画像の②のコマンドをコピーします。
  5. 下記のコマンドを実行します。1行目は、手順4でコピーしたコマンドの末尾に --add-source /dotnet-tools を付けたものです。

    dotnet tool install --global Implem.PleasanterSetup --version 1.0.1 --add-source /dotnet-tools
    echo 'export PATH="$PATH:$HOME/.dotnet/tools"' >> ~/.bashrc
    echo 'export DOTNET_ROOT=/usr/local/bin' >> ~/.bashrc
    echo 'export PATH=$PATH:$DOTNET_ROOT' >> ~/.bashrc
    source ~/.bashrc
    

    上記はImplem.PleasanterSetupのバージョンが1.0.1の場合の例です。

4⃣ プリザンターのセットアップ

インストーラは、最新バージョンのモジュールを自動でダウンロードし、入力した値を元にService.json、Rds.jsonの値を自動設定します。

「データベースのセットアップ」でセットアップしたデータベースのタブを選択してください。
表示された指示に従って、プリザンターをセットアップしてください。

  1. インストーラを起動します。下記のコマンドを実行してください。

    pleasanter-setup
    
    ネットワークに接続できない場合
    1. あらかじめダウンロードセンターから最新バージョンのプリザンターをダウンロードし、/web/に配置してください。/web/ディレクトリ配下の構成が下記のようになっていることを確認してください。

      /web/Pleasanter_1.5.x.x.zip
      
    2. 下記のコマンドを実行してください。

      pleasanter-setup -r /web/Pleasanter_1.5.x.x.zip
      
  2. プリザンターをインストールするディレクトリを設定します。
    既定では /web/pleasanter にインストールされます。
    Enter キーを押下してください。

    Install Directory [Default: /web/pleasanter] :
     
    
  3. <プリザンターを起動するユーザ> を入力し、Enter キーを押下してください。

    Please enter the user who will execute Pleasanter.
    <プリザンターを起動するユーザ>
    
  4. サービス名を設定します。
    既定では Implem.Pleasanter と設定されます。
    Enter キーを押下してください。

    ServiceName [Default: Implem.Pleasanter] :
     
    
  5. 使用するデータベースを選択します。
    2 を入力し、Enter キーを押下してください。

    DBMS [1: SQL Server, 2: PostgreSQL, 3: MySQL] :
    2
    
  6. データベース接続に利用するポート番号を設定します。
    既定では5432番ポートが設定されます。
    Enter キーを押下してください。

    Please enter port number[Default: 5432]
     
    
  7. 接続文字列のServerに設定する値を入力します。
    既定ではlocalhostが設定されます。
    Enter キーを押下してください。

    ConnectionString Server [Default: localhost] :
     
    
  8. SaConnectionStringのUIDに設定する値(ユーザID)を入力します。
    既定ではpostgresが設定されます。
    Enter キーを押下してください。

    SaConnectionString UID [Default: postgres] :
     
    
  9. SaConnectionStringのPWDに設定する値(パスワード)を入力してください。
    「データベースのセットアップ」で設定した、管理ユーザ「postgres」のパスワードを入力します。

    SaConnectionString PWD :
    Enter your password:
    ********
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  10. OwnerConnectionStringのPWDに設定する値(パスワード)を入力してください。

    OwnerConnectionString PWD :
    Enter your password:
    ************
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  11. UserConnectionStringのPWDに設定する値(パスワード)を入力してください。

    UserConnectionString PWD :
    Enter your password:
    ***********
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  12. 「既定の言語」を入力します。
    対応する言語の番号を入力してください。

    DefaultLanguage [1: English(Default), 2: Chinese, 3: Japanese, 4: German, 5: Korean, 6: Spanish, 7: Vietnamese] :
    3
    
  13. 「既定のタイムゾーン」を入力します。
    対応するタイムゾーンの番号を入力してください。

    Set the default time zone.
    TimeZoneDefault [1: UTC(Default), 2: Asia/Tokyo, 3: Other] :
    2
    

    「3: Other」を選択した場合

    3 を選択した場合は、OSで利用できるタイムゾーンを入力してください。

  14. サマリ画面が表示されます。入力した値に間違いがないことを確認してください。
    「Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :」に Y を入力し、Enter キーを押下して実行してください。

    ------ Summary ------
    Install Directory         : /web/pleasanter
    DBMS                      : PostgreSQL
    SaConnectionString PWD    : **********
    OwnerConnectionString PWD : **********
    UserConnectionString PWD  : **********
    Port                      : 5432
    Server                    : localhost
    Service Name              : Implem.Pleasanter
    DefaultLanguage           : ja
    DefaultTimeZone           : Asia/Tokyo
    [Issues]
        Class       :
        Num         :
        Date        :
        Description :
        Check       :
        Attachments :
    [Results]
        Class       :
        Num         :
        Date        :
        Description :
        Check       :
        Attachments :
    ---------------------
    Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :
    y
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  15. インストールするプリザンターのEditionについて確認されます。
    Community Editionの場合は Y と入力し、Enter キーを押下してください。

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    y
    
  16. 下記ログが表示されたらセットアップは終了です。

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    トライアルを開始するには `pleasanter-setup trial` を実行してください。
    トライアルの始め方と、インストール後の次の一歩は、こちらのページをご覧ください。
    https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  17. セットアップが終了すると、WebブラウザでEnterprise Editionの90日間トライアルの案内ページが開きます。Webブラウザを開けない環境(GUIの無いサーバなど)では、案内ページのURLが画面に表示されます。セットアップはこれで完了しています。続けて次の手順に進んでください。

    セットアップの完了後に開くEnterprise Editionの90日間トライアルの案内ページ

  1. インストーラを起動します。下記のコマンドを実行してください。

    pleasanter-setup
    
    ネットワークに接続できない場合
    1. あらかじめダウンロードセンターから最新バージョンのプリザンターをダウンロードし、/web/に配置してください。/web/ディレクトリ配下の構成が下記のようになっていることを確認してください。

      /web/Pleasanter_1.5.x.x.zip
      
    2. 下記のコマンドを実行してください。

      pleasanter-setup -r /web/Pleasanter_1.5.x.x.zip
      
  2. プリザンターをインストールするディレクトリを設定します。
    既定では /web/pleasanter にインストールされます。
    Enter キーを押下してください。

    Install Directory [Default: /web/pleasanter] :
     
    
  3. <プリザンターを起動するユーザ> を入力し、Enter キーを押下してください。

    Please enter the user who will execute Pleasanter.
    <プリザンターを起動するユーザ>
    
  4. サービス名を設定します。
    既定では Implem.Pleasanter と設定されます。
    Enter キーを押下してください。

    ServiceName [Default: Implem.Pleasanter] :
     
    
  5. 使用するデータベースを選択します。
    3 を入力し、Enter キーを押下してください。

    DBMS [1: SQL Server, 2: PostgreSQL, 3: MySQL] :
    3
    
  6. データベース接続に利用するポート番号を設定します。
    既定では3306番ポートが設定されます。
    Enter キーを押下してください。

    Please enter port number[Default: 3306]
     
    
  7. 接続文字列のServerに設定する値を入力します。
    既定ではlocalhostが設定されます。
    Enter キーを押下してください。

    ConnectionString Server [Default: localhost] :
     
    
  8. SaConnectionStringのUIDに設定する値(ユーザID)を入力します。
    既定ではrootが設定されます。
    Enter キーを押下してください。

    SaConnectionString UID [Default: root] :
     
    
  9. SaConnectionStringのPWDに設定する値(パスワード)を入力してください。
    「データベースのセットアップ」で設定した、MySQLのrootアカウントのパスワードを入力します。

    SaConnectionString PWD :
    Enter your password:
    ********
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  10. OwnerConnectionStringのPWDに設定する値(パスワード)を入力してください。

    OwnerConnectionString PWD :
    Enter your password:
    ************
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  11. UserConnectionStringのPWDに設定する値(パスワード)を入力してください。

    UserConnectionString PWD :
    Enter your password:
    ***********
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  12. MySqlConnectingHostに設定する値を入力します。
    既定では%が設定されます。特段の要件がない場合は Enter キーを押下してください。
    MySQLに対するアクセス制限を行う場合は、Rds.jsonを参照して設定してください。
    Ver.1.4.17.1以前のバージョンをインストールする場合は、そのまま Enter キーを押下してください。

    MySQL Connecting Host [Default: %] :
     
    
  13. 「既定の言語」を入力します。
    対応する言語の番号を入力してください。

    DefaultLanguage [1: English(Default), 2: Chinese, 3: Japanese, 4: German, 5: Korean, 6: Spanish, 7: Vietnamese] :
    3
    
  14. 「既定のタイムゾーン」を入力します。
    対応するタイムゾーンの番号を入力してください。

    Set the default time zone.
    TimeZoneDefault [1: UTC(Default), 2: Asia/Tokyo, 3: Other] :
    2
    

    「3: Other」を選択した場合

    3 を選択した場合は、OSで利用できるタイムゾーンを入力してください。

  15. サマリ画面が表示されます。入力した値に間違いがないことを確認してください。
    「Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :」に Y を入力し、Enter キーを押下して実行してください。

    ------ Summary ------
    Install Directory         : /web/pleasanter
    DBMS                      : MySQL
    SaConnectionString PWD    : **********
    OwnerConnectionString PWD : **********
    UserConnectionString PWD  : **********
    Port                      : 3306
    Server                    : localhost
    Service Name              : Implem.Pleasanter
    MySqlConnectingHost       : %
    DefaultLanguage           : ja
    DefaultTimeZone           : Asia/Tokyo
    [Issues]
        Class       :
        Num         :
        Date        :
        Description :
        Check       :
        Attachments :
    [Results]
        Class       :
        Num         :
        Date        :
        Description :
        Check       :
        Attachments :
    ---------------------
    Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :
    y
    

    パスワードは表示されない

    入力したパスワードはマスクされ、確認することができません。

  16. インストールするプリザンターのEditionについて確認されます。
    Community Editionの場合は Y と入力し、Enter キーを押下してください。

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    y
    
  17. 下記ログが表示されたらセットアップは終了です。

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    トライアルを開始するには `pleasanter-setup trial` を実行してください。
    トライアルの始め方と、インストール後の次の一歩は、こちらのページをご覧ください。
    https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  18. セットアップが終了すると、WebブラウザでEnterprise Editionの90日間トライアルの案内ページが開きます。Webブラウザを開けない環境(GUIの無いサーバなど)では、案内ページのURLが画面に表示されます。セットアップはこれで完了しています。続けて次の手順に進んでください。

    セットアップの完了後に開くEnterprise Editionの90日間トライアルの案内ページ

5⃣ プリザンターのサービス登録

プリザンターが起動することを確かめてから、サービスとして登録します。

  1. 下記のコマンドを実行して、あらかじめ決めたユーザでプリザンターを起動します。

    cd /web/pleasanter/Implem.Pleasanter
    sudo -u <プリザンターを起動するユーザ> /usr/local/bin/dotnet Implem.Pleasanter.dll
    
  2. 起動中に別のターミナルで下記のコマンドを実行し、プリザンターが起動していることを確認します。

    curl -v http://localhost:5000/
    

    「HTTP/1.1 302 Found」と、ログイン画面(/users/login)へのLocationが返れば起動しています。下記は表示の抜粋です。

    *   Trying [::1]:5000...
    * Connected to localhost (::1) port 5000
    > GET / HTTP/1.1
    > Host: localhost:5000
    > User-Agent: curl/8.5.0
    > Accept: */*
    < HTTP/1.1 302 Found
    < Content-Length: 0
    < Server: Kestrel
    < Location: http://localhost:5000/users/login?ReturnUrl=%2F
    
  3. 確認できたら、プリザンターを起動したターミナルで Ctrl+C キーを押下し、プリザンターを終了します。

  4. /etc/systemd/system/pleasanter.service を下記の内容で作成します。User には、あらかじめ決めたプリザンターを起動するユーザを指定してください。

    [Unit]
    Description = Pleasanter
    Documentation =
    Wants=network.target
    After=network.target
    
    [Service]
    ExecStart = /usr/local/bin/dotnet Implem.Pleasanter.dll
    WorkingDirectory = /web/pleasanter/Implem.Pleasanter
    Restart = always
    RestartSec = 10
    KillSignal=SIGINT
    SyslogIdentifier=dotnet-pleasanter
    User = <プリザンターを起動するユーザ>
    Group = root
    Environment=ASPNETCORE_ENVIRONMENT=Production
    Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
    
    [Install]
    WantedBy = multi-user.target
    
  5. 下記のコマンドを実行して、サービスを登録し、プリザンターを起動します。

    sudo systemctl daemon-reload
    sudo systemctl enable pleasanter
    sudo systemctl start pleasanter
    

6⃣ リバースプロキシ(nginx)のセットアップ

通常のWebサーバと同じポート80でアクセスできるように、リバースプロキシを設定します。

SELinuxを有効にしている場合

Ubuntuは既定ではSELinuxを使用しません。SELinuxを有効にしている環境で getenforce を実行して「Enforcing」と表示される場合は、下記のコマンドを実行してください。

sudo setsebool -P httpd_can_network_connect on

SELinuxのこのブール値を変更すると、該当のサーバにおいて、スクリプトやモジュールによるネットワーク接続がすべて許可されます。

  1. 下記のコマンドを実行して、nginxをインストールします。

    sudo apt install -y nginx
    sudo systemctl enable nginx
    
  2. 下記のコマンドを実行して、nginxの既定のサイトを無効にします。

    sudo rm /etc/nginx/sites-enabled/default
    

    既定のサイトを残した場合

    既定のサイトが有効なままだと、server_nameと異なるホスト名やIPv6でアクセスしたときに、プリザンターではなく「Welcome to nginx!」のページが表示されます。

  3. /etc/nginx/conf.d/pleasanter.conf を下記の内容で作成します。server_name には、実際にアクセスするサーバのホスト名またはIPアドレスを指定します。

    server {
        listen  80;
        listen  [::]:80;
        server_name   192.168.1.100;
        client_max_body_size 100M;
        location / {
           proxy_pass         http://localhost:5000;
           proxy_http_version 1.1;
           proxy_set_header   Upgrade $http_upgrade;
           proxy_set_header   Connection keep-alive;
           proxy_set_header   Host $host;
           proxy_cache_bypass $http_upgrade;
           proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header   X-Forwarded-Proto $scheme;
        }
    }
    
  4. 下記のコマンドを実行して、nginxを再起動します。

    sudo systemctl restart nginx
    
  5. 下記のコマンドを実行して、SSHと、ポート80(HTTP)へのアクセスを許可します。

    SSHを許可せずにファイアウォールを有効にしない

    SSHを許可せずにファイアウォールを有効にすると、SSHの新しい接続が拒否され、SSHでサーバに接続できなくなります。SSHで接続して作業している場合は、必ず先にSSHを許可してください。
    OpenSSH が許可するのはポート22です。SSHのポートを変更している場合は、sudo ufw allow <ポート番号>/tcp でそのポートを許可してください。

    sudo ufw allow OpenSSH
    sudo ufw allow 80/tcp
    
  6. 下記のコマンドを実行して、ファイアウォールを有効にします。
    確認を求められるので、Y を入力し、Enter キーを押下してください。

    sudo ufw enable
    
    Command may disrupt existing ssh connections. Proceed with operation (y|n)?
    y
    Firewall is active and enabled on system startup
    
  7. 下記のコマンドを実行して、SSHとポート80が許可されていることを確認します。

    sudo ufw status numbered
    

7⃣ プリザンターの動作確認

初期ユーザでプリザンターへログインし、初期ユーザのパスワードを変更します。

  1. Webブラウザで、server_nameに指定したホスト名またはIPアドレス(例:http://192.168.1.100/)を開きます。
    プリザンターのログイン画面が表示されたら、下記の情報を入力し、「ログイン」ボタンをクリックしてください。

    ラベル 入力情報
    ログインID Administrator
    初期パスワード pleasanter

    プリザンターのログイン画面。ログインIDと初期パスワードを入力する

  2. ログイン後にユーザ「Administrator」のパスワード変更を求められます。
    任意のパスワードを2度入力し、「変更」ボタンをクリックしてください。

    初回ログイン後に表示される、Administrator のパスワード変更画面

プリザンターの画面が開かない場合
  • 「Welcome to nginx!」のページが表示される場合は、nginxの既定のサイトが有効なままです。「リバースプロキシ(nginx)のセットアップ」の手順2を実施し、nginxを再起動してください。
  • 正しくリダイレクトされない場合は、nginxの設定が正しいか確認してください。記述内容の / の有無など細かな違いで動作が変わる場合があります。

対応バージョン

対応バージョン 内容
1.4.9.0 以降 MySQLに対応
1.4.10.0 以降 MySQLのアクセス制御機能によりOwner、Userの接続が拒否される場合がある問題を解消1
1.4.18.0 以降 MySQLのDBへの接続元ホストにlocalhost(DBと同一のサーバ)以外を指定する機能を追加
1.5.0.0 以降 .NET 10、PostgreSQL 18に対応

関連情報