> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjumper.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom License Server

> Configure Jumper to authenticate against an on-premises license server for air-gapped environments

<Info>
  Please contact support via email or Discord to get free help configuring this feature for your facility.
</Info>

## Overview

For production companies with air-gapped or tightly controlled networks, Jumper Pro can run as a **local license server**. This allows one online Jumper Pro machine to host licenses for other Jumper clients on the same network.

When configured, the designated Jumper Pro machine (the **license server**) connects to Jumper’s cloud for activation, and other Jumper clients on your network validate their licenses against that local server. This keeps all client license traffic on your internal network while still allowing central license management.

## Prerequisites

Before configuring clients to use a custom license server, ensure that:

* You have designated a machine running **Jumper Pro** that will act as the license server
* The license server machine has a stable internet connection for initial license activation
* The license server is reachable from all client machines (same LAN/VPN, or properly routed network)
* You have the correct address (IP or hostname, and port) that client machines will use to reach the license server
* Network connectivity and firewall rules between Jumper clients and the license server are properly configured

## Configuring the license server

<Steps>
  <Step title="Choose and activate your license server machine">
    Pick a machine that will run **Jumper Pro** and remain available whenever other Jumper clients need to validate licenses. Activate Jumper Pro on this machine using your license key as normal (with internet access).

    If you are unsure how to best set this up for your environment, please contact support via email or Discord and we will help you configure it.
  </Step>

  <Step title="Open Settings on each client machine">
    On every Jumper client machine that should use the local license server, navigate to the [Settings tab](/interface/settings-tab).
  </Step>

  <Step title="Find License Server IP address section">
    Locate the **License Server IP address** section in the settings. This section is located below the License key field.
  </Step>

  <Step title="Enter your license server IP address">
    In the License Server input field, enter the IP address of the Jumper Pro machine acting as your license server.

    **Example:** `192.168.1.38`

    <Info>
      The port number is always 6699 but you don't need to enter it.
    </Info>
  </Step>

  <Step title="Apply the configuration">
    Click the **Apply** button to save the license server IP address configuration.
  </Step>

  <Step title="Enter your license key">
    After configuring the license server IP address on a client, enter that machine’s license key in the **License key** field above and click **Apply** to activate its license against your local server.
  </Step>
</Steps>

## Verifying the configuration

After applying the license server IP address and license key:

* The license key input field should display a green border and check mark if authentication was successful
* License validation requests will now be sent to your on-premises server instead of the default Jumper license server
* All license-related network traffic will stay within your internal network

## Troubleshooting

<AccordionGroup>
  <Accordion title="License key is not accepted after configuring custom server">
    **Verify license server IP address**: Double-check that the IP address is correct. Ensure there are no typos or extra spaces.

    **Test network access**: Try pinging the license server IP address from the device running Jumper. Verify that the port is open and accessible.

    **Confirm license server is running**: Ensure your on-premises license server is running and accessible on the specified port.

    **Check firewall settings**: Verify that firewall rules allow communication between Jumper clients and the license server on the required port.
  </Accordion>

  <Accordion title="Windows firewall blocking license server connection">
    If you're running the license server on Windows and experiencing connection issues, you may need to configure Windows Defender Firewall to allow incoming connections on port 6699.

    <Steps>
      <Step title="Open Windows Defender Firewall">
        Open **Windows Defender Firewall with Advanced Security** from the Start menu or Control Panel.
      </Step>

      <Step title="Create inbound rule">
        Click **Inbound Rules** in the left sidebar, then click **New Rule** in the right sidebar.
      </Step>

      <Step title="Configure port rule">
        Select **Port** -> **Next** -> Select **TCP** -> Select **Specific local ports** and enter `6699` -> **Next**
      </Step>

      <Step title="Allow connection">
        Select **Allow the connection** -> **Next** -> Check all profiles (Domain, Private, Public) -> **Next**
      </Step>

      <Step title="Name the rule">
        Enter a name such as **Jumper Backend** -> **Finish**
      </Step>
    </Steps>

    After creating this rule, the license server should be able to accept incoming connections on port 6699 from Jumper clients on your network.
  </Accordion>
</AccordionGroup>