What is a print agent?

A print agent is a warehouse PC (Windows or Mac) running the Print Station app. Once paired, Luminous queues labels and documents directly to its connected printers — no manual download step on every print job.

Step 1 — Download and install the Print Station app

  1. Go to Settings → Print Agents (under Operations).

  2. Click the Install Print Agent button. Luminous detects your operating system and offers the correct installer automatically — Windows users see the .exe build, Mac users see the .pkg build. A secondary link lets you grab the other platform's file if needed.

  3. Install the app:

    Windows

    • Run PickFlow-Print-Station-Setup.exe as administrator.
    • Open Print Station from the desktop shortcut.

    macOS

    • Open PickFlow-Print-Station.pkg. macOS will show a warning that the installer is unsigned — this is expected.
    • Go to System Settings → Privacy & Security and click Open Anyway, or right-click the .pkg file and choose Open.
    • Open PickFlow Print Station from Applications.

Step 2 — Pair the station with Luminous

  1. On the Print Agents settings page, click Pair new print agent.
  2. A 6-character code appears with a 5-minute countdown.
  3. In the Print Station app on the warehouse PC, enter that code when prompted.
  4. Once paired, the station appears in the Paired Agents table with an Online status badge.

Tip: If the code expires before you enter it, click Pair new print agent again to generate a new one.

Step 3 — Select a default printer and run a test print

  1. In the Print Station app, select the default printer for that station.
  2. Back in Luminous on the Print Agents page, click Test print next to the station to confirm the connection end-to-end.

Managing paired agents

The Print Agents page lists every paired station with its name, host machine, online/offline/revoked status, default printer, and last heartbeat time. The station list refreshes automatically every 30 seconds.

ActionWhat it does
Test printSends a test job to the station's default printer to verify connectivity.
RevokeImmediately stops the station from receiving new print jobs. The station must be paired again before it can print.
DeletePermanently removes the station and its entire print job history. This cannot be undone.

Viewing recent print jobs

The Recent Print Jobs table (bottom of the Print Agents page) shows the last 50 jobs across all stations — status (Pending, In progress, Sent to printer, Failed, Cancelled), job type, target printer, and any error messages for failed jobs.

Note: A status of "Sent to printer" means Luminous handed the payload to the OS print spooler. It does not confirm the printer had paper or ink at that moment.

Troubleshooting

Station shows Offline Check that the Print Station app is running on the warehouse PC and that the machine has network access to Luminous. The status updates on the next heartbeat (up to 30 seconds).

macOS blocks the installer This is expected for unsigned packages. Follow the Privacy & Security → Open Anyway path described in Step 1, or right-click the .pkg and choose Open.

Pairing code expired Codes are valid for 5 minutes. Click Pair new print agent to generate a fresh one.

Test print fails with an error listing available printers The station's default printer may not be configured. Open the Print Station app on the warehouse PC, select a printer as default, then retry the test print from Luminous.