Data & Backups
What persists in your agent, how full workspace backups work, and what happens when you destroy an agent.
Destroying an agent is permanent. It removes the agent and its entire runtime environment. If you want to keep your workspace, create a backup first.
What persists automatically
Your agent workspace is persistent — files survive normal restarts. The platform also persists:
Your account & auth
Sign-in state and account data are always kept.
Agent records
Deployment metadata, status, and configuration.
Secrets
Encrypted at rest, never wiped on restart.
Backup catalog
Backup entries and metadata tracked per agent.
Agent workspace persistence
The workspace is a persistent volume. Terminal work, cloned repos, downloaded assets, and runtime-generated files all survive restarts. You don't need to re-set up your environment every time an agent reboots.
Creating a backup
AgentStead exposes on-demand full workspace backups. Use them before any risky change.
Open backups
Either from the agent detail panel → Backups tab, or from the account-level Backups page.
Create the backup
Click Create backup. The platform snapshots the current workspace state and stores it in your backup catalog.
Pin, download, or delete
Backups can be:
- Pinned — protected from auto-cleanup
- Downloaded — saved to your local machine
- Deleted — freed from your quota
Backup flow
Backup quota
| Tier | Included |
|---|---|
| All accounts | 50 MB free |
| 5 GB add-on | £4/mo |
| 25 GB add-on | £12/mo |
| 100 GB add-on | £30/mo |
If your quota is nearly full, new backups will fail until you free space or upgrade your storage add-on.