Skip to content

I want to change the base URL in a Linux environment

Answer

Please change the settings according to the following procedure.

Overview

When installing Pleasanter in a Linux or Docker environment according to the "Install on Linux" procedure in the manual, the URL will be as follows:

http://localhost
(http://localhost:50001 in the Docker environment)

However, if you want to change this to a "Base URL" with a path such as
http://localhost/nakano

Please follow the steps below to set it up.

Cautions

  1. If you perform this procedure on a running Pleasanter, attachments, description column, images pasted in comments, and site images (icons) will no longer be displayed. To resolve this, attach or paste again. Please consider carefully before changing the base URL while it is running.

Operation Procedure

To change the base URL, follow the steps below. The following steps use the base URL as an example.

http://localhost/nakano

  1. Pleasanter startup settings
  2. nginx proxy settings
  3. Setting the parameter file "Service.json"
  4. Restarting Pleasanter and nginx

*The file paths shown in the following steps are for when you install according to the procedure in "Install on Linux", so please read them appropriately according to your environment.

1. Start Set Pleasanter

Add the parameter "--pathBase=/nakano" to the end of ExecStart for the Pleasanter service script (/etc/systemd/system/pleasanter.service) as follows:

  [Service]
  ExecStart = /root/dotnet/dotnet Implem.Pleasanter.dll

  [Service]
  ExecStart = /root/dotnet/dotnet Implem.Pleasanter.dll --pathBase=/nakano

2. Set nginx proxy

Add the path to the reverse proxy configuration file (/etc/nginx/conf.d/pleasanter.conf) in two places as follows.

    location / {
        proxy_pass         http://localhost:5000;

    location /nakano {
        proxy_pass         http://localhost:5000/nakano;

3. Set the parameter file Service.json

Set "AbsoluteUri" in "Service.json" as follows.

"AbsoluteUri": "http://localhost/nakano"

4. Restart pleasanter and nginx

Restart pleasanter and nginx using the following procedure.

sudo systemctl restart nginx
sudo systemctl restart pleasanter