Install Network Discovery - Linux

Updated
  • Updated on Feb 2, 2026
  • Published on Sep 22, 2025
  • 2 minute(s) read
  • NB
  • SG
 Prev Next

Most trials already include one hub and sensor. Use these instructions when you need to add a second or third Sensor, if you have additional networks, want to balance performance, or need redundancy.

Prerequisites

Supported operating systems

.deb packages:

  • Debian 12 (x64, current stable and previous release)

  • Ubuntu 22.04 LTS (x64, current LTS and previous LTS)

.rpm packages:

  • CentOS Stream 9 (x64, current and previous stream release)

  • Fedora 40 (x64, current and previous release)

  • openSUSE Leap 15.6 (x64, current and previous release)

  • Red Hat Enterprise Linux 8 (x64, current and previous minor release)

  • SUSE Linux Enterprise Server (SLES) 15 SP6 (x64, current and previous service pack)

Install the sensor and hub

  1. In your preferred site, go to Discovery > Systems > Download installers/packages.

  2. Select Network Discovery > Download Lansweeper repository package for the Linux Debian OS.

  3. Open a terminal and install the package:

    sudo dpkg -i ./lansweeper-repository.deb
sudo apt update

  4. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

    NOTE

    The expiration date indicates when the linking code can no longer be used to establish a new connection between a site and your discovery system. Any existing connection between the system and your site will remain active after the expiration date.

  5. Install the Network Discovery hub. Replace YourCloudTokenHere with your actual linking code and run:

    sudo env LINKING_CODE=YourCloudTokenHere apt install lansweeper-network-discovery-hub

  6. In your hub, go to Settings > Data transfer and copy your hub code.

  7. Install the sensor. Replace YourHubCodeHere with your actual hub code and run:

  8. sudo env HUB_CODE=YourHubCodeHere apt install lansweeper-network-discovery-it-sensor
sudo env HUB_CODE=YourHubCodeHere apt install lansweeper-network-discovery-ot-sensor

  9. Once the sensors are installed, go to their installation directory and open appsettings.json.

  10. In the file, find "HubUrl": "https://localhost:59525/IT/Sensor" and replace localhost with the name of your remote hub, for example "HubUrl": "https://MyRemoteHub01:59525/IT/Sensor".

  11. Restart the services:

    sudo systemctl restart lansweeper-network-discovery-it-sensor
sudo systemctl restart lansweeper-network-discovery-ot-sensor

  1. In your preferred site, go to Discovery > Systems > Download installers/packages.

  2. Select Network Discovery > Download Lansweeper repository package for the Linux Red Hat OS.

  3. Open a terminal and install the repository package you copied to your machine: 

    sudo dnf install ./lansweeper-repository-1-0-x86_64.rpm
sudo dnf update

  4. In your site, select Systems > Link discovery system > Create new code. Specify an expiration date, then select Apply and copy the generated code.

    NOTE

    The expiration date indicates when the linking code can no longer be used to establish a new connection between a site and your discovery system. Any existing connection between the system and your site will remain active after the expiration date.

  5. Install the Network Discovery hub. Replace YourCloudTokenHere with your actual linking code and run:

    sudo env LINKING_CODE=YourCloudTokenHere 
dnf install lansweeper-network-discovery-hub

  6. In your hub, go to Settings > Data transfer and copy your hub code.

  7. Install the sensor. Replace YourHubCodeHere with your actual hub code and run:

  8. sudo dnf install lansweeper-network-discovery-it-sensor
sudo dnf install lansweeper-network-discovery-ot-sensor

Next steps

Now that your hub and sensors are installed, you can create a discovery credential to access more asset details and create a discovery action to specify what to scan and when.

Related articles