Skip to main content
Percher is still being built and account creation is paused — get notified when it opens.
Percher

Versions and rollback

Git-backed deploy history

Ask your agent
Roll my app back to how it was before.Read the guide at percher.app/docs/versions
Show me my app's past versions.Read the guide at percher.app/docs/versions
How it works, with exact details

Every deploy is stored as a git commit in Percher's internal Forgejo instance. You can list versions and roll back to any previous deploy:

# List all versions
bunx percher versions
# e950cff  deploy: dep_850j...  2026-04-16
# 867d57f  Initial commit       2026-04-16

# Roll back to a specific version
bunx percher rollback e950cff

# No sha handy? Bare rollback lists the 5 most recent and lets you pick
bunx percher rollback

# Or let the server pick the most recent known-good version
bunx percher rollback --last-good

Rollback reuses the kept image for versions inside your plan's rollback retention (see History and retention). An older version is refused with ROLLBACK_TARGET_UNSUPPORTED unless you add --rebuild, which builds it again from its source with today's dependencies, so the result can differ from what originally shipped. --last-good resolves server-side to the most recent version that went live without crash-looping — the fastest way back when the current deploy is broken. You can also roll back from the Versions tab in the dashboard.