Printer controller¶
The Printer Controller is a compact device that manages all of your printers and print jobs from one place. It enables one-click printing from any device—computer, tablet, or smartphone—across Android, iOS, Windows, Mac, or Linux, and works in every major browser. You do not need to install printer drivers on individual devices; the controller handles everything.
Note
The printer controller is an optional add-on. Because Gem Logic runs in your browser, you can always print with your browser’s built-in print dialog. The controller is for businesses that want a streamlined experience with dedicated receipt, label, certificate, and document printers.
Important
Printer controllers are provided and configured by Gem Logic. When you order one, we set it up for your specific environment and ship it ready to use. Contact support@gem-logic.com to order a printer controller.
How it works¶
The printer controller continuously checks your Gem Logic instance for new print jobs:
A user clicks a print button in Gem Logic (for example, print receipt or print product label).
A print job is created and stored with the status Pending.
The printer controller polls for pending jobs every few seconds.
When a job is retrieved, the controller routes it to the configured printer.
The job status changes to Completed.
The connection indicator on the printer settings page shows whether a controller is actively connected. It turns green when the controller has polled within the last 15 seconds and refreshes automatically.
Installation¶
Setting up a printer controller takes three steps:
Connect the printer controller to your network with an Ethernet cable.
Power on the device.
The controller automatically connects to your Gem Logic instance.
Once connected, you can attach your printers:
Network printers: the controller automatically detects printers on the same network.
USB printers: connect them directly to the printer controller with a USB cable.
After the printers are connected, tell Gem Logic which printer to use for each document type on the Printer configuration page.
Multiple controllers¶
Each printer controller is tied to one marketplace, so a business with several shops or sales channels can run a controller per location. On the printer settings page, every connected controller appears as its own card (Controller 1, Controller 2, and so on) with its own configuration and connection status.
Restarting the controller¶
If the controller becomes unresponsive, open and use Restart controller at the bottom of the controller’s card. This restarts the service remotely and resolves most issues. If problems persist after restarting, contact Gem Logic support.