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
¶ Video Tutorial
¶ Requirements
Refer to supported operating systems: Supported OS/Distributions
¶ 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 through the members portal: https://docs.netlockrmm.com/en/members-portal
- Transfer both the NetLock agent installer and the downloaded
server_config.jsonfile to the target machine.
¶ Windows
- Open Command Prompt (CMD) or PowerShell as an administrator.
- Execute the NetLock agent installer with the following command:
"C:\Users\Administrator\Desktop\installer\NetLock_RMM_Agent_Installer.exe" clean "C:\Users\Administrator\Desktop\server_config.json"
¶ Linux & MacOS
- Open the terminal.
- Make the installer executable:
sudo chmod +x NetLock_RMM_Agent_Installer
- Execute it:
sudo ./NetLock_RMM_Agent_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.
¶ Generating & using one click installer
If you don’t want to use the server_config.json with parameters installation method, you can generate a single installer file.
- Under “Download installer” select the architecture of the target device you want to install on.
- Click on “Download installer” and give it a few seconds to process.
- Move the installer to the target device and execute it as administrator or root for linux & macOS.
The server_config.json is now embedded into the installer executable.
¶ Windows
You can now run the installer by right-clicking on it and selecting “Run as administrator.”
Or with CMD & PowerShell.
- Open Command Prompt (CMD) or PowerShell as an administrator.
- Execute the NetLock agent installer with the following command:
"C:\Users\Administrator\Desktop\installer\NetLock_RMM_Agent_Installer.exe"
- All set! Once installation is complete, the device should appear shortly in the web console under “Unauthorized.” Simply approve it to grant access.
¶ Linux & MacOS
- Open terminal.
- Make the installer executable:
sudo chmod +x path/to/installer
- Execute it:
sudo ./NetLock_RMM_Agent_Installer
- 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
Note: Using the one-click installer always cleans previous installations if no parameter is supplied.
¶ 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 on Windows.
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
¶ Requirements
Refer to supported operating systems: Supported OS/Distributions
- Execute it with your desired parameters using CMD or PowerShell.
¶ Parameters
uninstall- Removes all previous NetLock agent installations
¶ Windows
- Move the installer to the target device.
- Open CMD or PowerShell as administrator.
"C:\Users\Administrator\Desktop\uninstaller\NetLock_RMM_Agent_Installer.exe" uninstall
¶ Linux & MacOS
- Open the terminal.
- Make the installer executable:
sudo chmod +x NetLock_RMM_Agent_Installer
- Execute it:
sudo ./NetLock_RMM_Agent_Installer uninstall
Uninstallation complete.