License Server Help

Installation and Configuration

Download suitable installer

JetBrains License Server comes in two distributions: MSI and ZIP.

Windows MSI distributionZIP distribution
Download
SHA-256 checksum
Download
SHA-256 checksum

Double check the system and network requirements

In order for installation and setup to run smoothly, do not forget to check that your environment meets the requirements.

Install the License Server

MSI distributionZIP distribution
Launch the MSI installer, and when prompted provide installation directory. We will refer to it throughout the docs as license_server_home. Extract the contents of the ZIP package into a directory where you want the server to reside. We will refer to this directory throughout the docs as license_server_home.

Configure License Server host and port

Custom HTTP host and port for MSI distribution (optional)HTTP host and port for ZIP distribution
The License Server launched from the MSI installer will start on the first default port available on a machine from 8080 and above. To change it, follow these steps:
  1. Stop JetBrains License Service service.
  2. 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.
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 sh <license_server_home>/bin/license-server/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.

Reverse proxy configuration (optional)

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:

MSI distributionZIP distribution
Run the following command when the JetBrains License Service is stopped <license_server_home>\apps\license-server\bin\license-server.bat configure --jetty.virtualHosts.names=proxy-server.mydomain.com Run the following command when the JetBrains License Service is stopped <license_server_home>>bin\license-server.bat configure --jetty.virtualHosts.names=proxy-server.mydomain.com for Windows or<license_server_home> sh bin/license-server.sh configure --jetty.virtualHosts.names=proxy-server.mydomain.com for Linux and Mac OS X.

Here proxy-server.mydomain.com is the host of proxy or the host configured for usage by the license server. If there are several hosts, specify them comma separated.

Configure custom License Server URI (optional)

At this point the License Server URL that will allow products to access it will be the following:http://<configured host>:<configured port>. If you want, you can configure a custom License Server URI.

MSI distributionZIP 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.
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 distribution where C:\LicenseService is replaced by the path to the license server application

You are now ready to launch License Server. After you have made all configuration changes relevant in your environment, you can start License Server.You may also want to check if the License Server is able to connect to JetBrains Account correctly.

Last modified: 7 September 2018