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¶
- 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.
- MySQL can be used with ver1.4.9.0 and later. Pleasanter earlier than ver1.4.9.0 does not support MySQL.
- 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.
Preparations¶
Complete the preparations described in the following manual.
Install the Installer¶
Install the installer. Run the following command.
If you cannot connect to a network
-
Open the NuGet Gallery page for Implem.PleasanterSetup from here and download the .nupkg file from "Download package".
-
Create a folder of your choice to place the .nupkg file in. This procedure creates
C:\dotnet-toolswith the following command. -
Place the .nupkg file downloaded in step 1 in
C:\dotnet-tools. -
Run the following command to install the installer.
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.
-
Start the installer. Run the following command.
If you cannot connect to a network
-
Download the latest version of Pleasanter from the Download Center in advance and place it in
C:\web\. Make sure that the configuration under theC:\web\directory is as follows. -
Run the following command.
-
-
Set the directory where Pleasanter is installed.
By default, it is installed inC:\web\pleasanter.
Press the Enter key. -
Set the service name.
By default, it is set toImplem.Pleasanter.
Press the Enter key. -
Select the database to use.
Enter 1 and press Enter. -
Set the port number used to connect to the database.
By default, port 1433 is set.
Press the Enter key. -
Enter the value to set for Server in the connection string.
By default,localhostis set.
Press the Enter key. -
Enter the value (user ID) to set for UID in SaConnectionString.
By default,sais set.
Press the Enter key. -
Enter the value (password) to set for PWD in SaConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the value (password) to set for PWD in OwnerConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the value (password) to set for PWD in UserConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the "default language".
Enter the number of the corresponding language. -
Enter the "default time zone".
Enter the number of the corresponding time zone.If you select 3: Other
If you select 3, enter a time zone that can be used on the OS.
-
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)' . : yThe password is not shown
The password you enter is masked and cannot be checked.
-
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 -
You are asked to confirm the edition of Pleasanter to install.
For Community Edition, enter Y and press the Enter key. -
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. -
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.
-
Start the installer. Run the following command.
If you cannot connect to a network
-
Download the latest version of Pleasanter from the Download Center in advance and place it in
C:\web\. Make sure that the configuration under theC:\web\directory is as follows. -
Run the following command.
-
-
Set the directory where Pleasanter is installed.
By default, it is installed inC:\web\pleasanter.
Press the Enter key. -
Set the service name.
By default, it is set toImplem.Pleasanter.
Press the Enter key. -
Select the database to use.
Enter 2 and press Enter. -
Set the port number used to connect to the database.
By default, port 5432 is set.
Press the Enter key. -
Enter the value to set for Server in the connection string.
By default,localhostis set.
Press the Enter key. -
Enter the value (user ID) to set for UID in SaConnectionString.
By default,postgresis set.
Press the Enter key. -
Enter the value (password) to set for PWD in SaConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the value (password) to set for PWD in OwnerConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the value (password) to set for PWD in UserConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the "default language".
Enter the number of the corresponding language. -
Enter the "default time zone".
Enter the number of the corresponding time zone.If you select 3: Other
If you select 3, enter a time zone that can be used on the OS.
-
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)' . : yThe password is not shown
The password you enter is masked and cannot be checked.
-
You are asked to confirm the edition of Pleasanter to install.
For Community Edition, enter Y and press the Enter key. -
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. -
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.
-
Start the installer. Run the following command.
If you cannot connect to a network
-
Download the latest version of Pleasanter from the Download Center in advance and place it in
C:\web\. Make sure that the configuration under theC:\web\directory is as follows. -
Run the following command.
-
-
Set the directory where Pleasanter is installed.
By default, it is installed inC:\web\pleasanter.
Press the Enter key. -
Set the service name.
By default, it is set toImplem.Pleasanter.
Press the Enter key. -
Select the database to use.
Enter 3 and press Enter. -
Set the port number used to connect to the database.
By default, port 3306 is set.
Press the Enter key. -
Enter the value to set for Server in the connection string.
By default,localhostis set.
Press the Enter key. -
Enter the value (user ID) to set for UID in SaConnectionString.
By default,rootis set.
Press the Enter key. -
Enter the value (password) to set for PWD in SaConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the value (password) to set for PWD in OwnerConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
Enter the value (password) to set for PWD in UserConnectionString.
The password is not shown
The password you enter is masked and cannot be checked.
-
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.To restrict access to MySQL
Refer to Rds.json and configure it as appropriate.
-
Enter the "default language".
Enter the number of the corresponding language. -
Enter the "default time zone".
Enter the number of the corresponding time zone.If you select 3: Other
If you select 3, enter a time zone that can be used on the OS.
-
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)' . : yThe password is not shown
The password you enter is masked and cannot be checked.
-
You are asked to confirm the edition of Pleasanter to install.
For Community Edition, enter Y and press the Enter key. -
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. -
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.
Set Up IIS¶
Configure IIS using "Server Manager".
- Open the "Tools" menu in "Server Manager" and start "Internet Information Services (IIS) Manager".
-
In the left pane, select "Application Pools" - "DefaultAppPool" and click "Basic Settings" in the right pane.
-
Change ".NET CLR version" to "No Managed Code" and click the "OK" button.
-
In the left pane, select "Sites" - "Default Web Site" and click "Advanced Settings" in the right pane.
-
Enter "C:\web\pleasanter\Implem.Pleasanter" in "Physical Path" and click the "OK" button.
-
In the left pane, select "Sites" - "Default Web Site" and click "Restart" in the right pane to restart IIS.
-
After restarting, click "Browse *:80 (http)" in the right pane to start Pleasanter.
Check That Pleasanter Works¶
Log in to Pleasanter as the initial user and change the password of the initial user.
-
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 -
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.
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 |
-
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. ↩









