Skip to content

Backup, Restore, and Migration

Version 0.6.2 unifies workspace snapshots used by full local backups, WebDAV, S3, and self-hosted Web, preserving the database, version history, and complete resource files. Sync, backups, and selective exports serve different purposes.

Method Purpose Boundary
Full local .phub.gz backup Upgrade checkpoints, device migration, full restoration Keep it outside the workspace and preserve current data before restoring
Selective export Share or move selected assets Not a complete workspace recovery point
WebDAV / S3 Online multi-device sync Select one active sync source
Self-hosted Web Independent remote recovery snapshots Automatic tasks upload only; they do not pull or overwrite local data
Official Cloud Account-owned cloud assets and available sync features Scope depends on the client and membership page

Snapshots preserve Prompts, history, folders, tags, complete Skill packages, MCP, Plugins, Rules, and media. Copying only the database is insufficient: scripts, references, and images are part of the assets too.

Credentials and deployment paths remain device-managed. Check model services, sync connections, and Agent paths after restoring; backups do not automatically transfer every secret.

  1. Save current edits and create a full backup in data settings.
  2. Copy it to a safe location and retain the old device’s data.
  3. Install an appropriate version on the new device, select the backup, and confirm restoration.
  4. Check Prompt content and history, Skill attachments, MCP / Plugins, Rules, and images.
  5. Verify local paths and credentials before enabling online sync.

Version 0.6.2 migrates older data and preserves the original workspace if restoration fails. Preview 0.6.3-beta.1 further fixes startup and restoration blocked by unrecognized Skill directories and older recovery files; see the changelog.

In Settings → Data → Self-Hosted PromptHub, enter the server address and self-hosted credentials, then test version and backup support. Desktop and server must use the exact same version; a 0.6.2 desktop needs a 0.6.2 server.

Remote snapshots do not replace the server’s live workspace. Startup and scheduled backups only upload. Restoration is explicit and creates a local safety snapshot first. The experimental Cloudflare version’s older sync API is not a substitute for this backup flow.

CLI workspace exports are JSON bundles, not desktop .phub.gz files. Use their matching import command; see CLI. Git can version text rules and project Skills but does not replace a complete workspace backup.