Posly print-agent installer

This page hosts the bootstrap scripts that the admin Connect-Agent wizard uses to install the Posly print agent on a venue computer.

Internal If you arrived here directly, go to admin.posly.xyz > Settings > Printing > Walk me through. The wizard will pre-fill the tenant ID and token for you.

macOS / Linux

POSLY_TENANT_ID=... \
POSLY_API_URL=https://api.posly.xyz \
POSLY_AGENT_TOKEN=... \
curl -fsSL https://install.posly.xyz/agent.sh | bash

Windows (PowerShell as Administrator)

powershell -Command "& {
  $env:POSLY_TENANT_ID  = '...';
  $env:POSLY_API_URL    = 'https://api.posly.xyz';
  $env:POSLY_AGENT_TOKEN = '...';
  iwr https://install.posly.xyz/agent.ps1 -useb | iex
}"

Requirements

Node.js 20 LTS or newer, an internet connection, and a USB or LAN-connected thermal printer. Installer registers the agent as a LaunchAgent on macOS, a systemd user unit on Linux, or a Scheduled Task on Windows so it survives reboots and crashes.

Manual download

Prefer to inspect first? Direct links:

• agent.sh — Mac / Linux bootstrap
• agent.ps1 — Windows bootstrap
• posly-print-agent.tar.gz — agent source + install scripts

Issues? DM @poslypos on X or email admin@posly.xyz.