What it does
Bridges cloud services with physical printers. A Cloudflare Worker manages a print queue while Raspberry Pi agents running Python poll for jobs and drive local printers via CUPS.
How it works
The Pi agents poll the Workers API rather than requiring inbound connections, which simplifies networking — no port forwarding or firewall holes needed. Each agent authenticates with Cloudflare Access service tokens. Stuck print jobs auto-release after five minutes so they can be picked up by another printer.
Technical details
- Cloudflare Workers API manages the print queue and job lifecycle
- D1 stores print job records and status history
- Raspberry Pi agents run a Python polling daemon
- CUPS handles local printer communication
- Cloudflare Access service tokens for agent authentication
- Automatic job release after 5-minute timeout for stuck jobs
- Agents survive power loss and resume polling on reboot via systemd