Storage Management
Heaper stores data locally on your device for offline access and fast performance. Over time, cached thumbnails and synced content can accumulate. Here's how to manage local storage.
What's Stored Locally
| Data | Description |
|---|---|
| SQLite database | Local copy of block metadata, relations, and search index |
| Thumbnails | Preview images at multiple sizes |
| Cached files | Files downloaded for offline access |
Clearing Local Data
To free up space while keeping your data safe on the server:
- Open Settings → Heaps
- Select the heap you want to clear
- Click Clear Cache
- Confirm the action
This will just remove the full files of all the blocks that are not pinned to your device. The pinned attribute not on the block but on the file(better wording planned) means that it gets downloaded automatically on that specific device. Your data on the server is not affected.
Storage on Self-Hosted Instances
If you're self-hosting, your server stores:
- PostgreSQL database — All block data, relations, and CRDT documents
- Thumbnails — Generated previews (
/mnt/thumbnailsvolume) - File storage — User-uploaded files (
/mnt/storagevolume) - Backups — Automated database backups (
/mnt/backupsvolume)
Monitor disk usage on your server and configure backup retention to control how many days of backups are kept.