This page provides information on installing Network Discovery, and how you can start remote discovery of your IT and OT assets.
Network Discovery is currently a preview feature, so please anticipate occasional adjustments and improvements as we refine its performance.
Lansweeper's Network Discovery enables you to discover all IT and OT assets within your network. By utilizing the necessary discovery credentials, Network Discovery gathers all asset details both on the local machine and on remote IT assets.
On this page:
Requirements
During Preview, Network Discovery can produce duplicate assets. Optionally, you can resolve duplicate assets by going to Inventory > Duplicate conflicts and resolving the duplicates manually, or by going to Scanning > Discovery systems, unlinking the Network Discovery system(s), and removing all related data.
Connection requirements
The computer running the hub component of Network Discovery must allow the following outbound connections, when you've linked the hub with your Lansweeper Site:
If the computer running Network Discovery requires a proxy server, you can provide the details using a silent installation method.
Supported operating systems
Network Discovery can be installed on the following operating systems.
Windows
- Windows 10 21H2 or higher (x64)
- Windows 11 22000 or higher (x64)
- Windows Server 2012 or higher (x64)
Linux
.deb packages:
- Debian 10 up to penultimate version (x64)
- Ubuntu 16.04, 18.04, 20.04 up to penultimate version (x64)
.rpm packages:
- CentOS Linux 7 (x64)
- CentOS Stream Linux 8 up to penultimate version (x64)
- Fedora 36 up to penultimate version (x64)
- openSUSE 15 up to penultimate version (x64)
- Oracle Linux 7 up to penultimate version (x64)
- Red Hat Enterprise Linux 7 up to penultimate version (x64)
- SUSE Enterprise Linux (SLES) 12 SP2 up to penultimate version (x64)
MacOS
- macOS 10.15 up to penultimate version (x64)
System requirements
Specifications |
Minimum |
Recommended |
Processor |
x64, Quad-core 1 GHz or higher |
x64, Quad-core 2 GHz or higher |
Memory |
4 GB RAM |
16 GB RAM |
Disk size |
Hub: 100 GB Sensor: 50 GB |
Hub: 250 GB (caching) Sensor: 100 GB (logging storage) |
Network speed |
100 Mbps or higher |
1000 Mbps or higher |
Installation paths and logs
By default, Network Discovery will be installed in the following locations:
- Windows:
C:\Program Files\Lansweeper Network Discovery
- Linux:
/opt/lansweeper-hub
/opt/lansweeper-it-sensor
/opt/lansweeper-ot-sensor
- macOS:
/Application Support/Lansweeper Network Discovery
By default, logs can be found in the following locations:
sensors\logs\Lansweeper.IT.Sensor.log
hub\logs\Lansweeper.Discovery.Hub.log
- Windows Installer:
C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_Network_Discovery_installer.log
C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper_Network_Discovery_uninstaller.log
C:\Users\%USERNAME%\AppData\Local\Temp\Lansweeper.IT.Hub.log
Install Network Discovery on Windows
Install Network Discovery on Windows interactively
- Ensure your Windows operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
- Locate the Windows OS and select Download Network Discovery installer and Download Network Discovery silent installation configuration.
- Optionally, select Link Discovery system. In the pop-up, select Create new code, choose an expiration date, select Apply and select Copy code.
- Run the installer.
- Select I accept the agreement > Next.
- Choose which directory to install Network Discovery, then Next.
- Select Install Hub and Install IT Sensor.
- Specify another hostname for the machine hosting the hub if you’re only installing the IT Sensor.
- Specify another TCP port if you want to override the default port for Hub to Sensor communication.
- Select Next.
- If you copied a linking code earlier, you can paste it here. Otherwise, you can link your Lansweeper later from the Hub.
- Select Next.
- Select Open Hub after finishing the installer > Finish.
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Install Network Discovery on Windows silently
Method 1
- Ensure your Windows operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
- Locate the Windows OS and select Download Network Discovery installer and Download Network Discovery silent installation configuration.
- Select Link Discovery system. In the pop-up, select Create new code.
- Choose an expiration date, select Apply and select Copy code.
- On your Windows computer, open the downloaded lansweepernetworkdiscoveryinstallation.cfg file.
- In the file, replace
cloudtokenvalue
with your copied linking code. If the computer requires a proxy server, remove the #
for proxyserver=myproxyserver.domain.local
and proxyport=8080
.
mode=unattended
accepteula=1
path=C:\Program Files\Lansweeper Network Discovery
components=hub,itsensor,otsensor
hubinstance=localhost
hubport=59525
installnpcapdriver=1
dcomautoconfig=1
#cloudtoken=cloudtokenvalue
#proxyserver=myproxyserver.domain.local
#proxyport=8080
- In an elevated command prompt, enter the following command, replacing
X.X.X
in Lansweeper-network-discovery-X.X.X
with the version number of your installer:
Lansweeper-network-discovery-X.X.X-windows-x64-installer.exe --optionfile lansweepernetworkdiscoveryinstallation.cfg
The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Download installers/packages > Network Discovery installer > Version and locate your installer.
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Method 2
- Ensure your Windows operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems> Download installers/packages and navigate to the Full Network Discovery section.
- Locate the Windows OS and select Download Network Discovery installer.
- Select Link Discovery system. In the pop-up, select Create new code.
- Choose an expiration date, select Apply and select Copy code.
- Enter the following command in an elevated command prompt, replacing
cloudtokenvalue
with the copied linking code. If the computer requires a proxy server, add parameters --proxyserver proxyserveraddress
and --proxyport 8080
. Replace X.X.X
in Lansweeper-network-discovery-X.X.X
with the version number of your installer.
Lansweeper-network-discovery-X.X.X-windows-x64-installer.exe --mode unattended --accepteula 1 --path "C:\Program Files\Lansweeper Network Discovery Discovery" --cloudtoken cloudtokenvalue
The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Download installers/packages > Network Discovery installer > Version and locate your installer.
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Uninstall Network Discovery on Windows
To uninstall the Network Discovery on Windows, either:
Install Network Discovery on Linux
Only silent installs are currently supported for Network Discovery on Linux.
- Ensure your Linux operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
- Locate the Linux OS and select Download Lansweeper repository package for deb or rpm, depending on your Linux distribution.
- Select Link Discovery system. In the pop-up, select Create new code.
- Choose an expiration date, select Apply and select Copy code.
- Depending on your Linux distribution, follow the instructions below, replacing
cloudtokenvalue
with the copied linking code:
- Debian and Ubuntu:
- Install the repository package. Copy it to your machine.
- In a terminal, enter
sudo dpkg -i ./lansweeper-repository.deb
.
- Enter
sudo apt update
to make the system aware of the repository.
- Enter
sudo env LINKING_CODE=cloudtokenvalue apt install lansweeper-network-discovery-hub
.
- For the IT sensor, enter
sudo env apt install lansweeper-network-discovery-it-sensor
.
- For the OT sensor, enter
sudo env apt install lansweeper-network-discovery-ot-sensor
.
- Once there is an update, update the packages by entering
sudo apt update && apt upgrade lansweeper-network-discovery-hub
sudo apt update && apt upgrade lansweeper-network-discovery-it-sensor
sudo apt update && apt upgrade lansweeper-network-discovery-ot-sensor
- Red Hat, CentOS, and SUSE:
- Install the repository package. Copy it to your machine.
- In a terminal, enter
sudo yum install ./lansweeper-repository-1-0-x86_64.rpm
.
- Enter
sudo yum update
to make the system aware of the repository.
- Enter
sudo env LINKING_CODE=cloudtokenvalue
.
- Enter
sudo yum install lansweeper-network-discovery-hub
.
- For the IT sensor, enter
sudo yum install lansweeper-network-discovery-it-sensor
.
- For the OT sensor, enter
sudo yum install lansweeper-network-discovery-ot-sensor
.
- Once there is an update, update the packages by entering
sudo yum update && yum upgrade lansweeper-network-discovery-hub
sudo yum update && yum upgrade lansweeper-network-discovery-it-sensor
sudo yum update && yum upgrade lansweeper-network-discovery-ot-sensor
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Uninstall Network Discovery on Linux
To uninstall Network Discovery Linux, open your terminal and run the following commands, depending on your environment.
- Debian and Ubuntu:
sudo dpkg -r lansweeper-network-discovery
- Red Hat, CentOS, and SUSE:
sudo rpm -e lansweeper-network-discovery
Install Network Discovery on macOS
There are multiple you can use to install the Network Discovery on a macOS computer.
If the computer running Network Discovery requires a proxy server, use a silent install method.
Install Lansweeper Network Discovery on macOS interactively
- Ensure your macOS operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
- Locate the macOS with DMG format. Select Download Network disk image to download the installer.
- Select Link Discovery system. In the pop-up, select Create new code.
- Choose an expiration date, select Apply and select Copy code.
- Run the Network Discovery installer on your macOS machine. In the resulting pop-up, double-click the name of the installer, then Next.
If the software is blocked, click the Apple icon in the upper-left corner of your screen. Select System Preferences > Security & Privacy > Open Anyways.
- Select I accept the agreement > Next.
- Select the installation directory. By default, the directory is /Library/Application Support/Lansweeper Network Discovery. Select Next.
- Paste the Lansweeper linking code in the installer, then select Next.
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Install Network Discovery on macOS silently
Method 1 - PKG deployment
- Ensure your macOS operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
- Select Download Network Discovery package and Network Discovery macOS package silent installation configuration to download both files.
- Select Link Discovery system. In the pop-up, select Create new code.
- Choose an expiration date, select Apply and select Copy code.
- In the downloaded Network Discovery package silent installation configuration file, replace
cloudtokenvalue
with your copied linking code and modify the content to suit your needs. If the computer requires a proxy server, remove the #
for proxyserver=myproxyserver.domain.local
and proxyport=8080
.
#!/bin/sh
PreinstallConfig="/tmp/LansweeperNetworkDiscovery-Preinstall.cfg" # Don't change this path!
[ -f $PreinstallConfig ] && chmod 744 $PreinstallConfig
cat > $PreinstallConfig << EOF
mode=unattended
accepteula=1
path=/Library/Application Support/Lansweeper Network Discovery
cloudtoken=cloudtokenvalue
#proxyserver=myproxyserver.domain.local
#proxyport=8080
EOF
chmod 744 $PreinstallConfig
-
Enter the following command: sudo ./tmp/LansweeperPreinstallScript.sh
-
Enter the following command, replacing X.X.X
in LansweeperNetworkDiscovery-X.X.X
with the version number of your installer: sudo installer -pkg Lansweeper-network-discovery-X.X.X-osx-installer.pkg -target /
The version numbers for your installer can be found in your Lansweeper Site. Go to Scanning > Discovery systems > Download installers/packages.
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Method 2 - DMG deployment
- Ensure your macOS operating system is supported.
- Open a browser and navigate to https://app.lansweeper.com.
- If you have multiple Lansweeper Sites, select the site to which you want to link Network Discovery.
While Network Discovery is in preview, we recommend linking Network Discovery to a new Lansweeper Site with only Network Discovery or IT Agent Discovery systems.
- Go to Scanning > Discovery systems > Download installers/packages and navigate to the Full Network Discovery section.
- Locate the macOS with DMG format. Select Download Network disk image to download the installer.
- Select Link Discovery system. In the pop-up, select Create new code.
- Choose an expiration date, select Apply and select Copy code.
- In an elevated command prompt, enter
hdiutil attach Lansweeper-network-discovery-0.9.0-16-osx-installer.dmg
to mount the dmg file.
- Enter
cd "/Volumes/Lansweeper Network Discovery"
to navigate to the volume.
- Enter the following command, replacing
cloudtokenvalue
with the copied linking code and replacing X.X.X
in Lansweeper-network-discovery-X.X.X-X-osx-installer.dmg
with the version number of your installer. If the computer requires a proxy server, add parameters --proxyserver proxyserveraddress and --proxyport 8080.
sudo Lansweeper-network-discovery-X.X.X-X-osx-installer.app/Contents/MacOS/installbuilder.sh --mode unattended --accepteula 1 --path
Now that Network Discovery is installed, check out the Hub and configure Network Discovery.
Uninstall Network Discovery on macOS
To uninstall Network Discovery on macOS, you can either:
Start Network Discovery
Now that Network Discovery is installed, you can check out the Hub and start Network Discovery.
- If you haven't been redirected to the Hub from the previous steps, open a browser and navigate to https://localhost:59525.
- Go to Sensors to ensure the sensor is present.
- Go to Discover > Agentless discovery.
- Enter an IP address to scan.
- Under Discovery type select Credential-free device recognition.
- Select Discover.
- Go to Discovery queue to validate the scan has worked as expected.
- To see the details of a discovered asset, go to Discovery results and select a result.
Change the default certificate
- Generate your own .pfx file and password. For more information on creating a .pfx file, see How to create a .pfx file.
- In your installation folder, open appsettings.json.
- Search for "Certificate".
- Change the "Path" and the "Password" values to the values of the .pfx file you've generated earlier.
- Save the appsettings.json file.
- Restart the Lansweeper Network Discovery Hub service.
Frequently asked questions (FAQ)
For a list of answers to frequently asked questions, check out Network Discovery: Frequently Asked Questions.