Customize your server settings

The conf/whd.env environment configuration file defines your server options, such as the HTTP and HTTPS ports, JVM memory, and server hostname. This file is located at <WHD_HOME>/conf/whd.env.

When you upgrade Web Help Desk, installer-managed settings in whd.env are migrated automatically. The installer maps legacy settings (such as MAXIMUM_MEMORY and MINIMUM_MEMORY) to the new equivalent keys (WHD_JVM_MAX_MEMORY and WHD_JVM_MIN_MEMORY). Review whd.env after an upgrade to confirm all settings are correct.

If you update whd.env, you only need to restart the affected service for the changes to take effect. For most settings, restart the WHD backend service using your operating system's service tools. For Linux, use systemctl restart whd-backend. For Windows, use Restart-Service WHD-Backend. If you are making Caddy or port changes, you should also restart the WHD HTTP server service. A full system restart is not required.

The following sections explain how to customize and use the settings in the conf/whd.env file and the conf/application.properties file:

• Help desk ports
• Privileged networks
• TLS certificate settings for SSL connections
• Memory allocation
• Database connections
• Java command line options
• JVM arguments