Skip to main content
PercherPercher

Documentation

Everything you need to deploy your first app with Percher.

Quick start

Install, log in, deploy

Recommended configurations by app type

Resource and data presets per app type

CLI reference

All bunx percher commands

Environment variables

Set, unset, list, encryption

Password protection

SITE_PASSWORD env + [web] password = true

Deploy history and retention

Rollback deploys and log retention per plan

Telemetry

What's collected from the CLI

Versions and rollback

Git-backed deploy history

Deploy instruction for AI agents

CLAUDE.md content for agentic deploys

Crash diagnostics

AI-analyzed crash reports, percher_diagnose_crash

Zero-downtime deploys

Drain + canary + auto-rollback

Multi-instance & auto-scaling

resources.instances and [resources.autoscale]

Cost optimization insights

Idle, memory-pressure, overprovisioned, deploy-regression

Event webhooks

Signed deploy.failed / app.crashed / domain.expiring

Billing & plans

Dashboard, MCP, or Suggestions card

PocketBase — database, auth & files

Managed SQLite-backed backend

percher.toml — full reference

Every field and allowed value

MCP tools for AI assistants

All 27 MCP tools

Migrating from Supabase

Keep Supabase or switch to PocketBase

Migrating from Convex

Keep Convex or switch to PocketBase

Migrating from Vercel

What works, what needs changes

Custom domains

TXT + CNAME verification

Persistent app data

/app/data volume mount

Percher — AI-native app hosting