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.

Notes

  1. If you perform this procedure on a running Pleasaner, 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:

Before modification

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

After modification

[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.

Before modification

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

After modification

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