License Server Help

Configuring License Server host and port

HTTP host and port for ZIP package installation

Prior to starting License Server, you need to set the port and host that will be in use for HTTP communications.

To make License Server use a specified HTTP port, run <license_server_home>/bin/license-server.sh configure --port 8080 --listen license-server.mydomain.com for Linux and Mac OS X or <license_server_home>\bin\license-server.bat configure --port 8080 --listen license-server.mydomain.com for Windows where 8080 is the port number you want to use and license-server.mydomain.com is the host where the license server is available for end-users.

Custom HTTP host and port for MSI installer (optional)

The License Server launched from the MSI installer will start on the first default port available on a machine from 8080 and above. If you need to configure host and port different from the defaults, please follow these steps:

  1. Stop JetBrains License Service service.

  2. While the service is stopped run <license_server_home>\bin\license-server.bat configure --listen-port 8080 --base-url http://license-server.mydomain.com:8080 where 8080 is the port number you want to use and license-server.mydomain.com is the host where the new license server is available for end-users.

  3. Run JetBrains License Service service.

Reverse proxy configuration

If license server is running behind the reverse proxy or a host configured for license server software doesn't match a host of machine where the software is running, please configure virtual hosts property for the License server software:

  1. For ZIP distribution please run the following command when license server software is stopped <license_server_home>\bin\license-server.bat configure --jetty.virtualHosts.names=proxy-server.mydomain.com for Windows or <license_server_home>/bin/license-server.sh configure --jetty.virtualHosts.names=proxy-server.mydomain.com for Linux and Mac OS X.

  2. For MSI distribution please run the following command when JetBrains License Service is stopped <license_server_home>\apps\license-server\bin\license-server.bat configure --jetty.virtualHosts.names=proxy-server.mydomain.com.

where proxy-server.mydomain.com is the host of proxy or the host configured for usage by the license server.

If there are several hosts, please specify them comma separated.

Using configured server URL to obtain license

The product expects license server URL to be http://<configured host>:<configured port> as shown on the screenshot:

License server URL in product

License server URL may additionally contain a custom URI, configured as described below.

Configuring custom License Server URI

If you had a previous version of JetBrains License Server installed, you may need to configure a custom URI to get http://host:port/licenseServer to ensure smooth migration of users to the new Server.

ZIP distribution

Specify context=/licenseServer in <license_server_home>/conf/service-config.properties for Linux and Mac OS X or <license_server_home>\conf\service-config.properties for Windows in case of ZIP package where C:\LicenseService is replaced by the path to the license server application.

MSI distribution

  1. Stop JetBrains License Service service.

  2. While the service is stopped run <license_server_home>\bin\license-server.bat configure --listen-port 8080 --base-url http://license-server.mydomain.com:8080/licenseServer where 8080 is the port number you want to use and /licenseServer is the URI where the new license server is available for end-users.

  3. Run JetBrains License Service service.

You are now ready to launch License Server. After you have made all configuration changes relevant in your environment, you can start License Server.

http(s)://your-license-server-web-page/check-connection checks the connectivity and shows if our resources are available from your server.

http(s)://license-server-web-page/check-configuration shows where logs and config files are located on your copy of license server.

Last modified: 25 January 2018