License Server Help

Installation

Before the installation check that your environment meets the requirements.

License Server (FLS) is a Java-based application and requires Java 11 or later versions. To check the version of Java you have installed, run the following command:

java -version

Install FLS

  1. Download the ZIP archive.

    To check the downloaded file, compare its hash with SHA-256 checksum.

  2. Extract the contents of the ZIP package into a directory where you want the server to reside. We will refer to this directory as the FLS installation directory throughout the docs.

    unzip license-server-installer.zip -d <fls_home>
  3. Change to the selected installation directory using the command line.

  4. Make sure port 8080 is open.

    By default, FLS starts on host 0.0.0.0 and port 8080. If this port is used by another service, change the default port before starting FLS.

  5. Start FLS using the following command:

    ./bin/license-server.sh start

    If FLS starts successfully, the output should end with the following:

    JetBrains License Service is listening on {0.0.0.0:8080} JetBrains License Service is running

    It means that FLS started on the default host and port; however, this address is not secure. To change it, see Server URL.

To see the list of commands for managing FLS, run the script with the help command (or with no commands):

./bin/license-server.sh help

For more information about using those commands, see Commands reference.

If you want to run the management script from any location on your computer, you can add its location to the the $PATH variable.

License Server (FLS) is a Java-based application and requires Java 11 or later versions. To check the version of Java you have installed, run the following command:

java -version

Install FLS

  1. Download the ZIP archive.

    To check the downloaded file, compare its hash with SHA-256 checksum.

  2. Extract the contents of the ZIP package into a directory where you want the server to reside. We will refer to this directory as the FLS installation directory throughout the docs.

    unzip license-server-installer.zip -d <fls_home>
  3. Change to the selected installation directory using the command line.

  4. Make sure port 8080 is open.

    By default, FLS starts on host 0.0.0.0 and port 8080. If this port is used by another service, change the default port before starting FLS.

  5. Start FLS using the following command:

    ./bin/license-server.sh start

    If FLS starts successfully, the output should end with the following:

    JetBrains License Service is listening on {0.0.0.0:8080} JetBrains License Service is running

    It means that FLS started on the default host and port; however, this address is not secure. To change it, see Server URL.

To see the list of commands for managing FLS, run the script with the help command (or with no commands):

./bin/license-server.sh help

For more information about using those commands, see Commands reference.

If you want to run the management script from any location on your computer, you can add its location to the the $PATH variable.

Install FLS

  1. Download the MSI Installer.

    To check the downloaded file, compare its hash with SHA-256 checksum.

  2. Launch the MSI installer. It automatically creates a directory FLS in the common installation directory. We will refer to this directory as the FLS installation directory throughout the docs. Also, it creates the JetBrainsLS user, which requires incoming and outgoing connections with the JetBrains Account.

  3. Make sure port 80 is open.

    By default, FLS starts on host 127.0.0.1 and port 80. If this port is used by another service, change the default port before starting FLS.

  4. When you install FLS with an MSI distribution, it runs as a Windows service. The display name of the Windows service is JetBrains License Service. After the initial configuration, the application runs in the background on the machine.

    The default host and port are not secure. To change it, see Configuring host and port.

There are two ways to manage FLS:

  • To start, stop, and restart FLS, use the service JetBrains License Service.

    The service can be controlled using the Services snap-in for Microsoft Management Console (MMC). The list of Windows services is usually available in the Control Panel under Administrative Tools, and this requires administrator privileges.

    Alternatively, you can control Windows services from the command line locally using sc.exe. There are also PowerShell cmdlets to perform service management.

  • To configure FLS, use the management script license-service.bat in the License Server installation directory. For more information about using the script, see Commands reference.

    You can use the script to start and stop FLS, but in this case the server will run under current user and stop when the user's session ends.

    There are two similar license-server.bat scripts located under different directories in the FLS installation directory. The first is located under .\bin and it configures the MSI bundle of the FLS application. The second is located under .\app\license-server\bin and configures an application itself. Each procedure in this documentation has instructions on what script should you use.

If you want to run one of the management scripts from any location on your computer, you can add its location to the PATH variable.

FLS as a Linux service

You can create a Linux service that will start FLS on boot. In this case, starting happens with the start of the machine automatically.

Configure systemd

  1. Create an fls.service file in /etc/systemd/system/ with the following contents:

    [Unit] Description=JetBrains FLS Requires=network.target After=network.target [Service] Type=forking ExecStart=<fls-home>/bin/license-server.sh start ExecStop=<fls-home>/bin/license-server.sh stop ExecReload=<fls-home>/bin/license-server.sh restart PIDFile=<fls-home>/logs/launcher.pid [Install] WantedBy=default.target

    Customize the content of this file as needed:

    • Set the User parameter to the name of any existing machine user. In this configuration, Linux service doesn't depend on the user status.

    • Set the ExecStart parameter to the command that starts FLS. For example, if the FLS installation directory is /opt/fls-home, set the parameter value to /opt/fls-home/bin/license-server.sh start. Assign the similar commands to the ExecStop, ExecReload, and PIDFile parameters.

  2. Use the following command to reload the systemd daemon and enable the FLS service to start automatically:

    systemctl daemon-reload systemctl enable fls.service
  3. Use the following command to run the FLS service:

    systemctl start fls.service

    Use the following command to check the running service:

    systemctl status fls.service
Last modified: 25 August 2023