Skip to content
ZenPrint Docs

Getting Started

This guide takes you from “I just got a ZenPrint tenant” to “my first endpoint is reporting printers.” Budget 15–20 minutes of hands-on time.

Before you begin

You’ll need:

  • A ZenPrint tenant URL (e.g. acme-msp.zenprint.io) and admin credentials
  • Admin access to your RMM
  • One Windows endpoint at the customer site that’s already managed by that RMM

1. Log in and complete MFA

TODO: screenshot of MFA setup screen.

On first login, ZenPrint forces a TOTP MFA enrollment. Scan the QR code into your preferred MFA application. Save the recovery codes somewhere durable. If you lose your authenticator, enter one of the recovery codes at the login screen where it asks for the app code. Each recovery code works once. If you run out and can’t reach your authenticator, an admin has to reset your MFA.

2. Connect your RMM

The endpoint authenticates to ZenPrint with one piece of information: an API key. The server URL is already baked into the bootstrap script you download (the script is per-tenant).

  1. Go to Settings → API Keys → Create API Key. Give it a name (e.g. “Production”) and create it as a full-access key (leave “read-only” unticked, since the bootstrap needs to write). Copy the key now, because it’s only shown once.
  2. In your RMM, store the key as a secure custom field that the bootstrap script can read, set per organization.

See RMM Setup for the exact field names, screenshots, and the per-vendor walkthrough.

3. Deploy the bootstrap script

The bootstrap script authenticates with your API key, checks the endpoint in with ZenPrint, then fetches and runs the signed script for the mode you specify.

  1. Go to Settings → Scripts and download the bootstrap PS1 for your RMM.
  2. Save it as a new script in your RMM. You can run any mode ad-hoc from the RMM at any time, or schedule it on an interval (see Scripts for the per-mode cadence recommendations).
  3. Run it once manually on your test endpoint with -Mode Reconcile. Every mode checks the endpoint in first, so this registers the endpoint. With nothing assigned in ZenPrint yet, reconcile finds no queues to apply, which is expected; that comes later.

An endpoint only exists in ZenPrint once its bootstrap has run and checked in at least once, so run the bootstrap (use -Mode Reconcile) on every endpoint you want ZenPrint to manage.

Within a minute or two, the endpoint should appear in Fleet as Pending. Approve it there. Endpoints stay Pending until you approve them; ZenPrint never auto-activates one. A pending endpoint still checks in, scans, and polls, but it won’t reconcile any queues until you approve it.

4. Verify

TODO: screenshot of a freshly-registered endpoint in the fleet view.

You should see:

  • The endpoint in Fleet with status Active
  • Its currently-installed printer queues in the endpoint’s detail drawer (Fleet → Endpoints, click the row)
  • An entry in Settings → Audit Log showing the endpoint registered

Next steps