Install the Plenix Gateway Agent
The Gateway agent is the bridge between your on-premises networks and Plenix cloud monitoring. Install it before adding devices or printers.
What is the Gateway Agent?
The Plenix Gateway agent is a lightweight Windows service that runs on-site and connects your local network to the Plenix cloud platform. It enables:
- Printer monitoring via SNMP (toner levels, page counts, offline detection)
- Network topology discovery β mapping devices on the local network
- Agentless device monitoring β ping checks, port monitoring, SNMP queries for switches and routers
- Secure tunnel for RDP sessions via Plenix (Enterprise)
Gateway vs Device Agent: The Gateway agent is NOT the same as the per-device RMM agent. The RMM device agent installs on each Windows PC/server for deep telemetry (CPU, RAM, disk, processes, patches). The Gateway runs once per network/site to enable network-level monitoring and printer monitoring.
Requirements
| Requirement | |
|---|---|
| OS | Windows 10 / Windows Server 2016 or later |
| RAM | 256 MB free minimum |
| Network | Must be on the same subnet (or routable to) the devices you want to monitor |
| Outbound | HTTPS (port 443) to gateway.plenix.cloud |
| Inbound | UDP 161 from printer/device IPs to the gateway host (for SNMP) |
| Account | Local administrator or service account with admin rights |
Installation
Step 1 β Download the installer
-
In Plenix, go to RMM β Gateway Agents and click + Add Gateway.
-
Click Download Installer. The installer is personalised β it includes your tenant token. Do not share it with other tenants.
Step 2 β Run the installer
-
Copy the installer to the target Windows device.
-
Right-click β Run as administrator. The installer requires admin rights to register the Windows service.
-
Follow the installer wizard. When prompted, the tenant token is pre-filled from the download.
-
Click Install. The installer:
- Registers the
PlenixGatewayWindows service - Starts the service
- Phones home to register this gateway with your Plenix account
- Registers the
Step 3 β Verify in Plenix
Go to RMM β Gateway Agents. Within 1β2 minutes, the new gateway appears with status Online and a green dot. If it remains offline after 3 minutes, check:
- Windows Services: is
PlenixGatewayrunning? - Firewall: is outbound HTTPS allowed from this device?
- Event Viewer β Application log for PlenixGateway errors
Managing gateways
From RMM β Gateway Agents you can:
- Rename β give it a descriptive name (e.g. "BlueSky IT β Main Office")
- Link to a client β associate this gateway with a CRM company
- View status β last seen timestamp, version, connection health
- Update β trigger an in-place update to the latest agent version
What to do after installing
Once the gateway is online, you can:
- Add printers β go to Printer Monitoring and add printers reachable via this gateway
- Add network devices β go to Monitoring and add switches, routers, or any SNMP-enabled device
- Enable network discovery β Plenix will scan the subnet and discover devices automatically (optional)
Uninstalling
To remove the gateway:
- On the Windows host, go to Programs & Features β Plenix Gateway Agent β Uninstall
- In Plenix, go to RMM β Gateway Agents, find the gateway, and click Remove
Where to go next
Was this article helpful?