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.
Choose a path
Section titled “Choose a path”| 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 |
What a full backup preserves
Section titled “What a full backup preserves”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.
Move to another device
Section titled “Move to another device”- Save current edits and create a full backup in data settings.
- Copy it to a safe location and retain the old device’s data.
- Install an appropriate version on the new device, select the backup, and confirm restoration.
- Check Prompt content and history, Skill attachments, MCP / Plugins, Rules, and images.
- 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.
Self-hosted Web snapshots
Section titled “Self-hosted Web snapshots”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 export and restore
Section titled “CLI export and restore”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.