Install the Printdeck Agent

The Printdeck Agent runs on the LAN where your 3D printers live and opens an outbound tunnel so Printdeck can reach them without router port forwarding.

Linux & macOS

curl -fsSL https://install.printdeck.io/agent.sh | bash

Installs to /usr/local/bin/, registers a systemd unit, creates a dedicated printdeck-agent user.

Windows (elevated PowerShell)

irm https://install.printdeck.io/agent.ps1 | iex

Installs to %ProgramFiles%\Printdeck Agent\ and registers a Windows service.

Docker

PRINTDECK_BACKEND_URL=https://printdeck.app \
  docker compose run --rm printdeck-agent pair
docker compose up -d

Uses ghcr.io/cepheuslabs/printdeck-agent:latest with frpc pre-bundled. See agent-docker.md for the minimal docker-compose.yml.

Self-hosted Printdeck

Default backend URL is https://printdeck.app (the hosted SaaS). If you're running your own Printdeck server, pass your URL via env var before piping:

PRINTDECK_BACKEND_URL=https://printdeck.acme.com \
  bash -c "$(curl -fsSL https://install.printdeck.io/agent.sh)"

After install

Pair the agent to your organization:

sudo -u printdeck-agent /usr/local/bin/printdeck-agent pair

Prints a code + URL. Open the URL, approve in the Printdeck dashboard, start the service. Full walkthrough at docs.printdeck.io/install/pair-flow.