CLI reference

All bunx percher commands

percher publishStandard deploy — handles login, config, deploy, error diagnosis

percher publish --dry-runVerify the bundle (file count, bytes) without uploading

percher publish --previewDeploy to a temporary preview URL (does not replace live)

percher publish -m "note"Add a note shown in deploy history

percher initInitialize a project with percher.toml

percher create <name> --template nodeCreate a new app from a template

percher pushGranular deploy: upload + deploy phase only (use after login + init)

percher deploys [app]List recent deploys (id, status, error)

percher deploys inspect <id>Full deploy status + build log

percher deploys inspect --latest-failedInspect the most recent failed deploy

percher preview promote <id>Promote a preview deploy to live

percher preview discard <id>Discard a preview deploy

percher logs [app]Stream runtime logs (requires running container)

percher logs [app] --tail 50View last 50 runtime log lines

percher env set KEY=VALSet an environment variable

percher env listList environment variables (masked)

percher env unset KEYRemove an environment variable

percher data [app]Show PocketBase status, collections, and stats

percher doctor [app]Run health and connectivity diagnostics

percher domains add <domain>Add a custom domain and print DNS records

percher domains verify <domain>Verify domain ownership and routing

percher domains listList custom domains

percher domains remove <domain>Remove a custom domain

percher versionsList deploy history with commit SHAs

percher rollback <sha>Roll back to a previous version

percher whoamiShow current user and token info

percher loginAuthenticate via browser (device flow)

percher openOpen the app URL in your browser