Skip to main content
PercherPercher

CLI reference

All bunx percher commands

percher publish prints a pre-flight summary (detected framework, Node version + its source, build/health/port, bundle size) before upload, so a wrong autodetect is visible up front. On failure it surfaces the build-log tail, missing env vars, and any classified diagnosis inline — no need to dig into the API to find the log. Pre-build infra failures are tagged infra_unavailable so you know to retry rather than fix code.

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 publish --no-cacheSkip the image-cache lookup and force a fresh build (use when changes aren't reflected)
percher initInitialize a project with percher.toml
percher create <name> --template nodeCreate a new app from a template
percher pushLow-level: upload + deploy phase only (prefer percher publish)
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 logs [app] --buildShow the BUILD log (defaults to latest failed deploy)
percher logs [app] --build dep_xyzShow the build log for a specific deploy
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 data reset-superuser <app>Rotate PB superuser, re-inject as POCKETBASE_ADMIN_PASSWORD (encrypted)
percher data reset-superuser <app> --revealSame, but also print the plaintext password once
percher doctor [app]Recovery hub — diagnoses publish/deploy failures and prints the exact next action
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
PrevRecommended configurations by app typeNextGitHub & CI/CD
CLI reference — Percher docs