Instead of compiling all binaries yourself, you can easily obtain them through our Members Portal. We offer free unsigned executables for home labs, as well as digitally code-signed executables for professionals. This option simplifies the setup process and ensures you have the latest and most secure versions of our software. For more details about our Members Portal and the available packages, visit: https://docs.netlockrmm.com/en/members-portal
¶ Installation under Windows
¶ Video Tutorial
¶ Requirements
Refer to supported operating systems: Supported OS/Distributions
- .NET Framework 4.7.2 Runtime Download .NET Framework 4.7.2 | Free official downloads (microsoft.com)
- Warning: Executing the .NET Framework setup in silent mode may trigger necessary system updates, which could result in an unexpected reboot of your Windows installation.
¶ Step by Step
¶ Create a New Agent Server Configuration
- Open your web console.
- In the top right corner, click the button with the display and download arrow to open the dialog.
- Create a new configuration.
- Select the newly created configuration.
- Under Communication Server, enter the IP address/hostname and port of your NetLock server (comm). We really recommend hostnames/domains for SSL usage. IP’s are NOT reliable and NOT recommended:
- Examples:
netlockrmm.com:7443,demo.netlockrmm.com:7443. You can specify multiple servers as fallback options by separating them with commas.
- Examples:
- Repeat this process for each of the other NetLock server roles.
- Select the desired tenant.
- Select the desired location.
- Choose the desired language. This setting affects reporting; the language of the machine is irrelevant.
- Save the configuration.
- Download the configuration.
- Obtain the NetLock agent installer from GitHub: Releases · 0x101-Cyber-Security/NetLock-RMM-Agent-Installer-Windows · GitHub.
- Transfer both the NetLock agent installer and the downloaded
server_config.jsonfile to the target machine. - Open Command Prompt (CMD) or PowerShell as an administrator.
- Execute the NetLock agent installer with the following command:
"path\to\installer" clean "path\to\server_config.json"
- All set! Once installation is complete, the device should appear shortly in the web console under “Unauthorized.” Simply approve it to grant access.
After authorizing the device, it may take up to two minutes for it to start gathering information and updating in the web console. Remote features will become available approximately 3 minutes after initial authorization. To enable remote control (TeamViewer alternative), make sure to reboot the machine, and ensure the user you want to control is logged in.
¶ Parameters
clean- Removes all previous NetLock agent installations
- Recommended for fresh installations
fix- Removes existing NetLock agent installations, excluding the health agent. Updates the old server_config.json with the values provided in the new
server_config.json. - Recommended for updating the server configuration or repairing the agent installation without affecting the agents’ authorization.
- Removes existing NetLock agent installations, excluding the health agent. Updates the old server_config.json with the values provided in the new
¶ Examples
Fresh installation:
"C:\Users\Administrator\Desktop\installer\NetLock RMM Agent Installer (Windows).exe" clean "C:\Users\Administrator\Desktop\server_config.json"
Fix installation:
"C:\Users\Administrator\Desktop\installer\NetLock RMM Agent Installer (Windows).exe" fix "C:\Users\Administrator\Desktop\server_config.json"
¶ Firewall
The NetLock agent installer retrieves the agent packages and the NetLock agent uninstaller from the backend. Ensure it has access to these resources.
NetLock agents automatically configure the required exceptions in Windows Firewall according to your server settings, eliminating the need for manual configuration.
Once the installation is complete, you should be able to see the device listed under unauthorized devices in the system. It may take a minute for it to appear. Once it does, you will need to authorize the device, after which it will be listed under authorized devices.
¶ Uninstallation under Windows
¶ Requirements
- Windows 7 (with ALL updates installed), 8.1 (with ALL updates installed), 10, 11, Server 2008R2, 2012R2, 2016, 2019, 2022 (64-bit only)
- .Net Framework 4.7.2 Runtime Download .NET Framework 4.7.2 | Free official downloads (microsoft.com)
- Warning: Executing the .NET Framework setup in silent mode may trigger necessary system updates, which could result in an unexpected reboot of your Windows installation.
¶ Steps
- Execute it with your desired parameters using CMD or PowerShell.
¶ Parameters
clean- Removes all previous NetLock agent installations
- Recommended for fresh installations
fix- Only used in combination with the NetLock agent installer
¶ Examples
"C:\Users\Administrator\Desktop\uninstaller\NetLock RMM Agent Uninstaller (Windows).exe" clean