Feeder Agent · Installer

Download the PrintMetrix Feeder.

Install in under 60 seconds on any Windows, Linux, or macOS machine. The Feeder discovers your printers via SNMP, sends counter readings every 30 minutes, and registers with PrintMetrix using the claim code from the onboarding wizard.

Windows

Windows 10 / 11 · 64-bit · PowerShell as Administrator

irm https://printmetrix.com/download/install.ps1 | iex

Download install.ps1 View source

Linux

Ubuntu · Debian · CentOS · Alpine · x86_64 / arm64 · sudo required

curl -fsSL https://printmetrix.com/download/install.sh | sudo bash

Download install.sh View source

macOS

macOS 12 Monterey+ · arm64 (Apple silicon) / x86_64 · sudo required

curl -fsSL https://printmetrix.com/download/install.sh | sudo bash

Same script as Linux — auto-detects macOS.

Download install.sh View source

Before you start

Requirements

Memory512 MB RAM minimum
Storage100 MB free disk space
NetworkHTTPS outbound to api.printmetrix.com
PrivilegesAdministrator (Windows) or sudo (Linux / macOS)
SupportedWindows 10+ · Windows 11 · macOS 12 Monterey+ · Ubuntu 20.04+ · Debian 10+ · CentOS 8+ · Alpine 3.16+

Inside the agent

What the Feeder does — and what it doesn't

✓Discovers printers on your network via SNMP. No agents on the printers themselves.
✓Sends counter readings, toner levels, and device status every 30 minutes.
✓Registers automatically using the claim code from the onboarding wizard. Zero manual config.
✓Encrypted upstream — HTTPS only, certificate-pinned to api.printmetrix.com.
✗Does not read or transmit document content. Only counter metadata: page totals, color/B&W splits, supply percentages, status codes.

Common questions

FAQ

Does it need administrator rights?

Yes. SNMP requires elevated privileges on Windows to bind to the protocol stack, and the Feeder installs itself as a Windows Service / systemd unit so it survives reboots. On Linux you'll see sudo prompts during install for the same reasons.

What data does the Feeder collect?

Page counters (mono / color / total), toner and consumable levels, device status (online / warning / offline), error codes, and printer model metadata. No print job content, document images, or user identifiers are ever read or transmitted. The Feeder talks to printers only — never to file shares, document spoolers, or user workstations.

Is the connection encrypted?

HTTPS only, with TLS 1.2+ to api.printmetrix.com. The Feeder pins our certificate so even if your network sees a man-in-the-middle attempt, the connection refuses to fall back to a different cert. Outbound port 443 only — no inbound ports are opened.

What happens if the network goes down?

The Feeder buffers up to 7 days of readings locally in a SQLite database. When the connection comes back it replays everything in order, so you don't lose data during ISP outages or maintenance windows.

How do I update the Feeder?

The Feeder self-updates from PrintMetrix's signed release feed. New versions are verified against our public key before installation; if signing fails, the update is rejected and the existing version keeps running. You can also re-run the installer to force a manual update.

How do I uninstall it?

Windows: printmetrix-feeder uninstall from an elevated PowerShell, or remove via Apps & Features.
Linux: sudo printmetrix-feeder uninstall. Both commands stop the service, remove the binary, and clean up the systemd / Service Control Manager entry.