Setup

Before the Printer Client can receive print jobs, you need to create an API key in MPH WMS and connect the client.

Step 1: Create a printer client in MPH WMS

Go to Settings → Printers in the web app
Click Add Client
Enter a name for this workstation (e.g., "Packstation 1", "Warehouse Office")
Click Create
Copy the API key - it starts with mph_ and is only shown once

Save the API key immediately. It cannot be retrieved after you close the dialog. If you lose it, you'll need to regenerate a new one.

Step 2: Configure the Printer Client

Open the Printer Client app
Enter the Server URL - your MPH WMS instance URL (e.g., https://app.mphwms.se)
Paste the API key you copied in step 1
Enter a Workstation Name (should match what you entered in the web app)
Click Connect

The client will authenticate with the server and register all printers connected to your computer.

Step 3: Verify the connection

Once connected, you'll see the Status page with:

Connection status - green dot means online
Detected printers - list of all printers available on this computer
Activity log - will show connection events

In the web app, go to Settings → Printers and verify that:

Your client shows as Online
The printers are listed under the client

What gets registered

When the client connects, it automatically detects all printers on your system:

Windows - uses PowerShell Get-Printer to discover printers
macOS / Linux - uses CUPS lpstat to discover printers

Each printer is registered with its system name, display name, and capabilities. If you add a new printer to your computer, click Refresh in the Printer Client to re-detect.

Security

The API key is hashed with SHA-256 before storage - the server never stores the raw key
All communication uses HTTPS
The client authenticates on every request using the API key as a Bearer token
Each client is scoped to a single tenant (organization)

Regenerating the API key

If an API key is compromised or lost:

Go to Settings → Printers in the web app
Find the client
Click Regenerate API Key
Copy the new key and update the Printer Client configuration

The old key is immediately invalidated.