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 (normal PowerShell)

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
}"

Admin password is not required for a standard install. If prompted for a Windows password near the end, press Enter to skip the optional boot trigger.

Requirements

An internet connection and a USB or LAN-connected thermal printer. Windows installs use existing Node.js when available, otherwise the installer tries a user-scope install and then a portable Node.js fallback. Windows downloads a ZIP package so it does not need tar.exe or an admin shell.

Update an existing agent

These commands keep the venue pairing, printer names, routing and printer configuration. Do not uninstall the existing agent first.

Windows: open normal PowerShell.

iex (irm install.posly.xyz/update.ps1)

macOS / Linux: open Terminal as the usual venue user.

curl -fsSL https://install.posly.xyz/update.sh | bash

Manual download

Prefer to inspect first? Direct links:

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

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