Skip to content

Install Pleasanter on Windows Using the Installer

Overview

This procedure is for building the operating environment of Pleasanter using the installer. You can also install it using the previous procedure of manually placing modules and setting parameters. Refer to the following for the manual installation procedure.

Target Environment/Version
OS Windows Server
DB SQL Server, PostgreSQL, or MySQL
Web Server IIS
Platform .NET 10
Pleasanter 1.5.0.0 and later

When using SQL Server as the DB with Pleasanter 1.5 or later, be sure to check the following manual.

Cautions

  1. When installing ver1.4.6 or later, if you run CodeDefiner without specifying arguments, it is set up with the language set to English and the time zone set to UTC. Specify the language and the time zone as necessary.
  2. MySQL can be used with ver1.4.9.0 and later. Pleasanter earlier than ver1.4.9.0 does not support MySQL.
  3. To use MySQL in a configuration where the web server and the DB server are separated, refer to "Configure MySQL to be used in a configuration where the web server and DB server" (Ver.1.4.18.0 and later) or "Configure the Web Server and DB Server to Use MySQL Separately" (Ver.1.4.17.1 and earlier).

Limitations

Installation using the installer applies to Ver1.5.0.0 and later. When installing Ver1.4.23.3 or earlier, refer to the manual installation procedure.

1⃣ Preparations

Complete the preparations described in the following manual.

2⃣ Install the Installer

Install the installer. Run the following command.

dotnet tool install -g Implem.PleasanterSetup
If you cannot connect to a network
  1. Open the NuGet Gallery page for Implem.PleasanterSetup from here and download the .nupkg file from "Download package".

    The NuGet Gallery page for Implem.PleasanterSetup, with "Download package"

  2. Create a folder of your choice to place the .nupkg file in. This procedure creates C:\dotnet-tools with the following command.

    mkdir C:\dotnet-tools
    
  3. Place the .nupkg file downloaded in step 1 in C:\dotnet-tools.

  4. Run the following command to install the installer.

    dotnet tool install -g --add-source C:\dotnet-tools Implem.PleasanterSetup
    

3⃣ Set Up Pleasanter

The installer automatically downloads the resources of the latest version and automatically sets the values of Service.json and Rds.json based on the values you enter.

Select the tab for the database that you set up in the preparations.
Set up Pleasanter by following the instructions shown.

  1. Start the installer. Run the following command.

    pleasanter-setup
    
    If you cannot connect to a network
    1. Download the latest version of Pleasanter from the Download Center in advance and place it in C:\web\. Make sure that the configuration under the C:\web\ directory is as follows.

      C:\web\Pleasanter_1.4.x.x.zip
      
    2. Run the following command.

      pleasanter-setup -r C:\web\Pleasanter_1.4.11.0.zip
      
  2. Set the directory where Pleasanter is installed.
    By default, it is installed in C:\web\pleasanter.
    Press the Enter key.

    Install Directory [Default: C:\web\pleasanter] :
     
    
  3. Set the service name.
    By default, it is set to Implem.Pleasanter.
    Press the Enter key.

    ServiceName [Default: Implem.Pleasanter] :
     
    
  4. Select the database to use.
    Enter 1 and press Enter.

    DBMS [1: SQL Server, 2: PostgreSQL, 3: MySQL] :
    1
    
  5. Set the port number used to connect to the database.
    By default, port 1433 is set.
    Press the Enter key.

    Please enter port number[Default: 1433]
     
    
  6. Enter the value to set for Server in the connection string.
    By default, localhost is set.
    Press the Enter key.

    ConnectionString Server [Default: localhost] :
     
    
  7. Enter the value (user ID) to set for UID in SaConnectionString.
    By default, sa is set.
    Press the Enter key.

    SaConnectionString UID [Default: sa] :
     
    
  8. Enter the value (password) to set for PWD in SaConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  9. Enter the value (password) to set for PWD in OwnerConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  10. Enter the value (password) to set for PWD in UserConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  11. Enter the "default language".
    Enter the number of the corresponding language.

    DefaultLanguage [1: English(Default), 2: Chinese, 3: Japanese, 4: German, 5: Korean, 6: Spanish, 7: Vietnamese] :
    3
    
  12. Enter the "default time zone".
    Enter the number of the corresponding time zone.

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

    If you select 3: Other

    If you select 3, enter a time zone that can be used on the OS.

  13. The summary screen is displayed. Make sure that the values you entered are correct.
    Enter Y for "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :" and press the Enter key to run the setup.

    ------ Summary ------
    Install Directory         : C:\web\pleasanter
    DBMS                      : SQLServer
    SaConnectionString PWD    : **********
    OwnerConnectionString PWD : **********
    UserConnectionString PWD  : **********
    Port                      : 1433
    Server                    : localhost
    Service Name              : Implem.Pleasanter
    DefaultLanguage           : ja
    DefaultTimeZone           : Tokyo Standard Time
    [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
    

    The password is not shown

    The password you enter is masked and cannot be checked.

  14. If the error "\<ERROR> Starter.ExitIfCertificateError: The TLS certificate of the database server could not be validated." is shown as below, a TLS certificate is not registered on the SQL Server to connect to. To connect without validating the certificate chain of the SQL Server's server certificate, enter Y and press the Enter key. For the risks of selecting Y, refer to "Notes on Connection Strings When Using SQL Server as the Database in Pleasanter".

    <INFO> Starter.Main: Implem.CodeDefiner 1.5.6.1
    <ERROR> Starter.ExitIfCertificateError: The TLS certificate of the database server could not be validated.
    The connection to SQL Server failed because the server certificate could not be validated.
    Installing a certificate that is trusted by this machine is recommended, but you can skip the validation instead.
    Add 'TrustServerCertificate=True;' to the ConnectionString and retry? Please enter 'y(yes)' or 'n(no)'. :
    

    If you enter N here, an error occurs and the installer exits. Register a TLS certificate on the SQL Server, and then run the installer again.

    If you enter Y, the string TrustServerCertificate=True; is appended to the end of each connection string.

    The connection to SQL Server failed because the server certificate could not be validated.
    Installing a certificate that is trusted by this machine is recommended, but you can skip the validation instead.
    Add 'TrustServerCertificate=True;' to the ConnectionString and retry? Please enter 'y(yes)' or 'n(no)'. :
    y
    'TrustServerCertificate=True;' was added to the ConnectionString in c:\web\pleasanter\Implem.Pleasanter\App_Data\Parameters\Rds.json.
    Retry Implem.CodeDefiner with 'TrustServerCertificate=True;'.
    <INFO> Starter.Main: Implem.CodeDefiner 1.5.6.1
    
  15. You are asked to confirm the edition of Pleasanter to install.
    For Community Edition, enter Y and press the Enter key.

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    y
    
  16. When the following log is shown, the setup is finished.

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    To enable the trial, please run `pleasanter-setup trial`.
    For how to start the trial and the next steps after installation, please visit https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  17. When setup is complete, the Enterprise Edition 90-day trial information page (Japanese) opens in a web browser. Setup is now complete. Continue to the next step.

    The Enterprise Edition 90-day trial information page that opens after setup is complete

  1. Start the installer. Run the following command.

    pleasanter-setup
    
    If you cannot connect to a network
    1. Download the latest version of Pleasanter from the Download Center in advance and place it in C:\web\. Make sure that the configuration under the C:\web\ directory is as follows.

      C:\web\Pleasanter_1.4.x.x.zip
      
    2. Run the following command.

      pleasanter-setup -r C:\web\Pleasanter_1.4.11.0.zip
      
  2. Set the directory where Pleasanter is installed.
    By default, it is installed in C:\web\pleasanter.
    Press the Enter key.

    Install Directory [Default: C:\web\pleasanter] :
     
    
  3. Set the service name.
    By default, it is set to Implem.Pleasanter.
    Press the Enter key.

    ServiceName [Default: Implem.Pleasanter] :
     
    
  4. Select the database to use.
    Enter 2 and press Enter.

    DBMS [1: SQL Server, 2: PostgreSQL, 3: MySQL] :
    2
    
  5. Set the port number used to connect to the database.
    By default, port 5432 is set.
    Press the Enter key.

    Please enter port number[Default: 5432]
     
    
  6. Enter the value to set for Server in the connection string.
    By default, localhost is set.
    Press the Enter key.

    ConnectionString Server [Default: localhost] :
     
    
  7. Enter the value (user ID) to set for UID in SaConnectionString.
    By default, postgres is set.
    Press the Enter key.

    SaConnectionString UID [Default: postgres] :
     
    
  8. Enter the value (password) to set for PWD in SaConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  9. Enter the value (password) to set for PWD in OwnerConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  10. Enter the value (password) to set for PWD in UserConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  11. Enter the "default language".
    Enter the number of the corresponding language.

    DefaultLanguage [1: English(Default), 2: Chinese, 3: Japanese, 4: German, 5: Korean, 6: Spanish, 7: Vietnamese] :
    3
    
  12. Enter the "default time zone".
    Enter the number of the corresponding time zone.

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

    If you select 3: Other

    If you select 3, enter a time zone that can be used on the OS.

  13. The summary screen is displayed. Make sure that the values you entered are correct.
    Enter Y for "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :" and press the Enter key to run the setup.

    ------ Summary ------
    Install Directory         : C:\web\pleasanter
    DBMS                      : PostgreSQL
    SaConnectionString PWD    : **********
    OwnerConnectionString PWD : **********
    UserConnectionString PWD  : **********
    Port                      : 5432
    Server                    : localhost
    Service Name              : Implem.Pleasanter
    DefaultLanguage           : ja
    DefaultTimeZone           : Tokyo Standard Time
    [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
    

    The password is not shown

    The password you enter is masked and cannot be checked.

  14. You are asked to confirm the edition of Pleasanter to install.
    For Community Edition, enter Y and press the Enter key.

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    y
    
  15. When the following log is shown, the setup is finished.

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    To enable the trial, please run `pleasanter-setup trial`.
    For how to start the trial and the next steps after installation, please visit https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  16. When setup is complete, the Enterprise Edition 90-day trial information page (Japanese) opens in a web browser. Setup is now complete. Continue to the next step.

    The Enterprise Edition 90-day trial information page that opens after setup is complete

  1. Start the installer. Run the following command.

    pleasanter-setup
    
    If you cannot connect to a network
    1. Download the latest version of Pleasanter from the Download Center in advance and place it in C:\web\. Make sure that the configuration under the C:\web\ directory is as follows.

      C:\web\Pleasanter_1.4.x.x.zip
      
    2. Run the following command.

      pleasanter-setup -r C:\web\Pleasanter_1.4.11.0.zip
      
  2. Set the directory where Pleasanter is installed.
    By default, it is installed in C:\web\pleasanter.
    Press the Enter key.

    Install Directory [Default: C:\web\pleasanter] :
     
    
  3. Set the service name.
    By default, it is set to Implem.Pleasanter.
    Press the Enter key.

    ServiceName [Default: Implem.Pleasanter] :
     
    
  4. Select the database to use.
    Enter 3 and press Enter.

    DBMS [1: SQL Server, 2: PostgreSQL, 3: MySQL] :
    3
    
  5. Set the port number used to connect to the database.
    By default, port 3306 is set.
    Press the Enter key.

    Please enter port number[Default: 3306]
     
    
  6. Enter the value to set for Server in the connection string.
    By default, localhost is set.
    Press the Enter key.

    ConnectionString Server [Default: localhost] :
     
    
  7. Enter the value (user ID) to set for UID in SaConnectionString.
    By default, root is set.
    Press the Enter key.

    SaConnectionString UID [Default: root] :
     
    
  8. Enter the value (password) to set for PWD in SaConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  9. Enter the value (password) to set for PWD in OwnerConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  10. Enter the value (password) to set for PWD in UserConnectionString.

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

    The password is not shown

    The password you enter is masked and cannot be checked.

  11. Enter the value to set for MySqlConnectingHost.
    By default, it is set to "%".
    Press the Enter key.
    When setting up version 1.4.17.1 or earlier, use the default setting.

    MySQL Connecting Host [Default: %] :
     
    

    To restrict access to MySQL

    Refer to Rds.json and configure it as appropriate.

  12. Enter the "default language".
    Enter the number of the corresponding language.

    DefaultLanguage [1: English(Default), 2: Chinese, 3: Japanese, 4: German, 5: Korean, 6: Spanish, 7: Vietnamese] :
    3
    
  13. Enter the "default time zone".
    Enter the number of the corresponding time zone.

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

    If you select 3: Other

    If you select 3, enter a time zone that can be used on the OS.

  14. The summary screen is displayed. Make sure that the values you entered are correct.
    Enter Y for "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. :" and press the Enter key to run the setup.

    ------ Summary ------
    Install Directory         : C:\web\pleasanter
    DBMS                      : MySQL
    SaConnectionString PWD    : **********
    OwnerConnectionString PWD : **********
    UserConnectionString PWD  : **********
    Port                      : 3306
    Server                    : localhost
    Service Name              : Implem.Pleasanter
    MySqlConnectingHost       : %
    DefaultLanguage           : ja
    DefaultTimeZone           : Tokyo Standard Time
    [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
    

    The password is not shown

    The password you enter is masked and cannot be checked.

  15. You are asked to confirm the edition of Pleasanter to install.
    For Community Edition, enter Y and press the Enter key.

    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    y
    
  16. When the following log is shown, the setup is finished.

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    To enable the trial, please run `pleasanter-setup trial`.
    For how to start the trial and the next steps after installation, please visit https://pleasanter.org/pleasanter-extensions-trial/
    Setup is complete.
    
  17. When setup is complete, the Enterprise Edition 90-day trial information page (Japanese) opens in a web browser. Setup is now complete. Continue to the next step.

    The Enterprise Edition 90-day trial information page that opens after setup is complete

4⃣ Set Up IIS

Configure IIS using "Server Manager".

  1. Open the "Tools" menu in "Server Manager" and start "Internet Information Services (IIS) Manager".
  2. In the left pane, select "Application Pools" - "DefaultAppPool" and click "Basic Settings" in the right pane.

    The IIS Manager Application Pools view, with "DefaultAppPool" and "Basic Settings"

  3. Change ".NET CLR version" to "No Managed Code" and click the "OK" button.

    The Edit Application Pool dialog, setting the .NET CLR version to "No Managed Code"

  4. In the left pane, select "Sites" - "Default Web Site" and click "Advanced Settings" in the right pane.

    IIS Manager with "Default Web Site" selected and "Advanced Settings" in the right pane

  5. Enter "C:\web\pleasanter\Implem.Pleasanter" in "Physical Path" and click the "OK" button.

    The Advanced Settings dialog, where the physical path of Pleasanter is entered

  6. In the left pane, select "Sites" - "Default Web Site" and click "Restart" in the right pane to restart IIS.

    IIS Manager with "Default Web Site" selected and "Restart" in the right pane

  7. After restarting, click "Browse *:80 (http)" in the right pane to start Pleasanter.

    The right pane of IIS Manager, with "Browse *.80(http)"

5⃣ Check That Pleasanter Works

Log in to Pleasanter as the initial user and change the password of the initial user.

  1. A web browser starts and the Pleasanter login screen is displayed.
    Enter the following information and click the "Login" button.

    Label Input
    Login ID Administrator
    Initial password pleasanter

    The Pleasanter login screen, where the login ID and initial password are entered

  2. After logging in, you are asked to change the password of the user "Administrator".
    Enter a password of your choice twice and click the "Change" button.

    The password change screen for the Administrator user, shown after the first login

Supported Versions

Supported Versions Body
1.4.9.0 and later Supports MySQL
1.4.10.0 and later Fixed the issue where Owner and User connections could be rejected due to MySQL's access control function1
1.4.18.0 and later Added the ability to specify a host other than localhost (the same server as the DB) as the source host for connecting to the MySQL DB
1.5.0.0 and later Supports .NET 10, Windows Server 2025, SQL Server 2025, and PostgreSQL 18

  1. A link to "Configure the Web Server and DB Server to Use MySQL Separately" (Ver.1.4.17.1 and earlier) was also added to the cautions. ↩