Files & persistent storage
Your AxonOS home folder lives on a personal persistent volume, so your files, installed packages, and settings are there the next time you launch — even after a session ends.
How persistence works
- Your home directory (
/home/aXonian) is backed by a private Docker volume tied to your wallet. - When a session ends — whether you release it or credits run out — the desktop is destroyed but the volume is saved.
- On your next session, the same volume is remounted and your work reappears.
Anything outside your home directory is part of the ephemeral desktop image and is reset each session. Save files, notebooks, and datasets under your home folder to keep them.
Offline storage billing
Storing data costs disk space, so AxonOS charges a small fee for a persistent volume while you're offline (no active session). This is deducted from your credit balance.
| Lifecycle event | Desktop | Volume | Billing |
|---|---|---|---|
| Active session | Running | Mounted | Compute credits deducted via heartbeat |
| Credits exhausted | Running (grace ≈2h) | Mounted | Billing paused — top up to continue |
| Grace period ends | Destroyed | Saved | Compute released; storage billing begins |
| Offline | — | Saved | Small storage charge accrues (balance can go negative) |
| Debt limit exceeded | — | Deleted | Volume is pruned to reclaim space |
The default storage rate is about 0.05 compute-minutes per GB per hour. Your balance is allowed to go slightly negative (accumulating a little debt) so a brief lapse won't delete your data.
If your balance falls below the debt limit (default ≈ −24 hours of compute equivalent) while you're offline, your persistent volume is deleted to reclaim disk. Top up before then, or move important data off-platform.
Moving data in and out
The desktop includes decentralized and peer-to-peer tools so you're never locked in:
📡IPFS Desktop
Publish and fetch datasets over the InterPlanetary File System for content-addressed sharing.
🔄Syncthing
Continuously sync a folder between AxonOS and your other machines, peer-to-peer.
⬇️Browser & terminal
Use the in-desktop browser or standard CLI tools (wget, curl, git) to pull data.
Tips
- Back up anything irreplaceable off-platform — persistent storage is a convenience, not a long-term archive.
- Keep a small credit buffer if you want your volume to survive longer periods offline.
- For large reproducible datasets, pin them on IPFS and re-fetch per session rather than storing them long-term.
Next, see what's installed in Your desktop & tools, or review costs in Pricing & AXGT.