Skip to content

docs: Document host enrollment from another device (--device) - #1056

Merged
InlinePizza merged 3 commits into
mainfrom
promptless/headless-host-enrollment
Sep 28, 2026
Merged

InlinePizza merged 3 commits into
mainfrom
promptless/headless-host-enrollment

Conversation

@promptless

@promptless promptless Bot commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

Proposed changes

Hosts without a local browser, such as machines reached over SSH, can now enroll for PIG trace collection by approving from another device. This adds that path to Enroll your hosts and announces it in the September 2026 changelog.

Source: Promptless/promptless #5250 (backend POST /v1/instruction-hub/host-enrollments/device-sessions) and its client counterpart Promptless/pig-toolchain #98 (promptless-host-runtime enroll --device, stacked on pig-toolchain #91).

  • Enroll your hosts, step 3: documents enroll --host <host> --device: the command prints an approval link to open on another device, needs no local browser, inbound port, or loopback callback, waits about 35 seconds, and returns "status": "setup_pending" if approval is still pending. Rerunning resumes the same approval until its 15-minute expiry, after which a new link is printed.
  • Troubleshooting: adds rows for a host with no local browser and for the per-deployment rate limit (429, 20 creations per minute and 100 pending sessions).
  • Changelog (September 2026): a New Features entry for browserless host enrollment.

Open items to confirm before merge

Checklist

  • Instructions and examples match the current product behavior.
  • Links and image references are valid.
  • Changed pages render correctly.

@vercel

vercel Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
promptless-docs Ready Ready Preview Sep 24, 2026 9:17pm UTC

Request Review

Comment thread src/content/docs/docs/governance/get-started/enroll-your-hosts.mdx
Comment thread src/content/docs/docs/governance/get-started/enroll-your-hosts.mdx
Comment thread src/content/docs/docs/governance/get-started/enroll-your-hosts.mdx
Comment thread src/content/docs/docs/governance/get-started/enroll-your-hosts.mdx
Comment thread src/content/changelog/changelogs/september-2026.mdx
…ost-enrollment

# Conflicts:
#	src/content/changelog/changelogs/september-2026.mdx
…ost-enrollment

# Conflicts:
#	src/content/changelog/changelogs/september-2026.mdx
@InlinePizza
InlinePizza marked this pull request as ready for review September 28, 2026 17:23
@InlinePizza
InlinePizza merged commit f595e04 into main Sep 28, 2026
6 checks passed
@promptless
promptless Bot deleted the promptless/headless-host-enrollment branch September 28, 2026 17:23

This branch was successfully deployed

1 active deployment
Preview — 97bb202b Deployed Sep 24, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants