PrintMaster Documentation on PrintMaster Docs

Configuration Guide

Mon, 01 Jan 0001 00:00:00 +0000

Configuration guide checked against source snapshot 565f4c0. This is a targeted accuracy pass, not an exhaustive reference.

Configuration Methods
Agent Configuration
Server Configuration
Environment Variables
Command Line Options

Configuration Methods

Startup configuration uses built-in defaults, TOML, then supported environment overrides. -config selects the file; CLI flags are not a generic override mechanism for settings.

Managed/UI settings are a separate layer. On the server, environment-set keys are locked against managed overrides. Agent runtime web settings also use persisted unified settings; do not assume every TOML key wins over UI settings.

Features Guide

Mon, 01 Jan 0001 00:00:00 +0000

Complete guide to PrintMaster’s features and capabilities.

Device Discovery
Device Monitoring
Multi-Site Management
WebSocket Proxy
Alerts & Notifications
Scheduled Scans
Auto-Updates
Security Features
API Access

Device Discovery

PrintMaster automatically discovers printers and copiers on your network using SNMP.

How Discovery Works

Port Scanning: Quick TCP scan to find devices with printer ports open (80, 443, 9100)
SNMP Detection: Query each candidate to confirm it’s a printer
Deep Scan: Collect detailed device information via SNMP

Discovery Methods

Method	Description	When Used
IP Range Scan	Scan a specified range of IP addresses	Manual configuration
Subnet Auto-Scan	Automatically scan local subnets	Default behavior
Single Device	Add a specific printer by IP	Known devices

Supported Devices

PrintMaster supports most SNMP-enabled printers and copiers, including:

Frequently Asked Questions

Mon, 01 Jan 0001 00:00:00 +0000

Common questions about PrintMaster.

General

What is PrintMaster?

PrintMaster is a cross-platform printer/copier fleet management system. It automatically discovers network printers, collects device information (model, serial number, page counts, toner levels), and provides a web interface for monitoring your print fleet.

Who is PrintMaster for?

Managed Service Providers (MSPs) - Monitor client print infrastructure
Managed Print Services (MPS) providers - Track usage and supplies
Copier dealers - Manage devices across customer sites
IT departments - Monitor corporate print fleets

Is PrintMaster free?

Yes, PrintMaster is open source and free to use under the MIT license.

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

This guide walks you through your first steps with PrintMaster after installation.

Overview
Standalone Agent Setup
Server + Agent Setup
Discovering Printers
Understanding the Dashboard
Next Steps

Overview

PrintMaster can be used in two modes:

Standalone Mode: Run just the agent to monitor printers at a single site
Server Mode: Run a central server with multiple agents across sites

Choose the setup that matches your needs:

Use Case	Recommended Setup
Single office, single network	Standalone Agent
Multiple sites, centralized management	Server + Agents
MSP managing multiple clients	Server + Agents (multi-tenant)

Standalone Agent Setup

If you’re monitoring printers at a single location, the standalone agent is all you need.

Installation Guide

Mon, 01 Jan 0001 00:00:00 +0000

This guide covers installing PrintMaster on all supported platforms.

Quick Install
Server Installation
Agent Installation
First-Time Setup

Quick Install

Server (Docker)

docker run -d \
 --name printmaster-server \
 -p 9443:9443 \
 -v printmaster-data:/var/lib/printmaster/server \
 -e ADMIN_PASSWORD=your-secure-password \
 ghcr.io/printmaster-org/printmaster-server:latest

Access at https://localhost:9443 with username admin and your chosen password. The default certificate is self-signed; use a trusted custom certificate or TLS-terminating proxy for production.

Troubleshooting Guide

Mon, 01 Jan 0001 00:00:00 +0000

Solutions for common PrintMaster issues.

Discovery Issues
Connection Issues
Web UI Issues
Service Issues
Database Issues
Performance Issues
Logs & Diagnostics

Discovery Issues

No Printers Found

Symptoms: Scan completes but no devices appear.

Solutions:

Verify network connectivity

# Can you reach the printer?
ping 192.168.1.100

Check SNMP is enabled on the printer
- Access the printer’s web interface
- Look for SNMP settings in Network or Security
- Ensure SNMP v1/v2c is enabled
Verify the SNMP community string

PrintMaster Documentation on PrintMaster Docs

Configuration Guide

Table of Contents

Configuration Methods

Features Guide

Table of Contents

Device Discovery

How Discovery Works

Discovery Methods

Supported Devices

Frequently Asked Questions

General

What is PrintMaster?

Who is PrintMaster for?

Is PrintMaster free?

Getting Started

Table of Contents

Overview

Standalone Agent Setup

Installation Guide

Table of Contents

Quick Install

Server (Docker)

Troubleshooting Guide

Table of Contents

Discovery Issues

No Printers Found