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.
The persistent home directory lives at /home/kasm-user/:
Everything inside /home/kasm-user/ persists across restarts. Files outside this directory (system packages, runtime binaries) are reset on redeploy.
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 and from deletion on agent destroy
- Downloaded — saved to your local machine
- Deleted — freed from your quota
Backup quota
| Tier | Included |
|---|---|
| All accounts | 500 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.
When you destroy an agent, all unpinned backups for that agent are automatically deleted and their quota freed. Pinned backups are kept. Pin any backup you want to retain before destroying an agent.