# Storage History

Storage History is an Unraid plugin that adds a native capacity-history tile to the Dashboard for traditional arrays and pool-only systems, recording used, free, and total space over time with growth estimates,. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4241/storage-history

## Description

Storage History is an Unraid plugin that adds a native capacity-history tile to the Dashboard for traditional arrays and pool-only systems, recording used, free, and total space over time with growth estimates, read/write meters, and collection-health states.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

38/100 (Low), based on 3 of 4 factors.
- Maintained: 68 (last commit 101 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Unraid: https://ca.unraid.net/apps/storage-history-1l17oox0u3l5px?q=Storage%20History
- GitHub: https://github.com/rka/unraid-storage-history

## Common questions

### How do I install the tile in Unraid?

Open Plugins → Install Plugin in Unraid and paste the plugin URL. After installation, use the Dashboard Content Manager to position the Storage History tile.

### Where is the capacity-history data stored for backup?

History is stored as append-only monthly JSON Lines files under history.d at the configured data path. The default path is /mnt/user/system/storage-history, which keeps normal sampling writes off the USB boot device.

### Will an older history.json file be lost after upgrading?

Existing history.json data is migrated automatically and retained as history.json.migrated for recovery.

### What does the Stale collection state mean?

Stale means the latest sample is substantially older than the configured interval. The possible states are Current, Collecting, Stale, and Paused.

### Does the live disk I/O meter persist after the Dashboard is reloaded?

No, live I/O is calculated from Linux disk statistics and retained only in memory by the open Dashboard. It resets when the page reloads and is not written to capacity history.

### How are plugin updates delivered?

Updates appear on Unraid's Plugins page and use the plugin's configured update URL.

---
Source: Our Local Host (https://ourlocalhost.com/app/4241/storage-history), the self-hosted and open-source app directory.
