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
OSWindows 10 / Windows Server 2016 or later
RAM256 MB free minimum
NetworkMust be on the same subnet (or routable to) the devices you want to monitor
OutboundHTTPS (port 443) to gateway.plenix.cloud
InboundUDP 161 from printer/device IPs to the gateway host (for SNMP)
AccountLocal administrator or service account with admin rights

Installation

Step 1 β€” Download the installer

  1. In Plenix, go to RMM β†’ Gateway Agents and click + Add Gateway.

  2. Click Download Installer. The installer is personalised β€” it includes your tenant token. Do not share it with other tenants.

Step 2 β€” Run the installer

  1. Copy the installer to the target Windows device.

  2. Right-click β†’ Run as administrator. The installer requires admin rights to register the Windows service.

  3. Follow the installer wizard. When prompted, the tenant token is pre-filled from the download.

  4. Click Install. The installer:

    • Registers the PlenixGateway Windows service
    • Starts the service
    • Phones home to register this gateway with your Plenix account

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 PlenixGateway running?
  • 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:

  1. Add printers β€” go to Printer Monitoring and add printers reachable via this gateway
  2. Add network devices β€” go to Monitoring and add switches, routers, or any SNMP-enabled device
  3. Enable network discovery β€” Plenix will scan the subnet and discover devices automatically (optional)

Uninstalling

To remove the gateway:

  1. On the Windows host, go to Programs & Features β†’ Plenix Gateway Agent β†’ Uninstall
  2. In Plenix, go to RMM β†’ Gateway Agents, find the gateway, and click Remove

Where to go next

Was this article helpful?