StoryScan

Docker app from Unknowncall's Repository

Overview

A stunning web-based disk analyzer for Unraid that transforms storage exploration into a visual experience. Interactive treemaps, powerful search and filtering, top 10 space hogs, directory comparison, historical size tracking, and dark mode support. Finally, a disk analyzer that's as beautiful as it is functional.

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

File PathPathrw

Host path to scan. Map your Unraid share(s) here.

Target
/media-server
Value
/mnt/user/Media Server/
Database StoragePathrw

Persistent storage for the SQLite database (historical scan data). Map to a location on your Unraid server to preserve history across container updates.

Target
/app/data
Value
/mnt/user/appdata/storyscan/
SCAN_DIRECTORIESVariable

Comma-separated list of directories inside the container to scan.

Default
/media-server
Value
/media-server
SCAN_CRON_ENABLEDVariable

Enable automatic background scanning on a schedule. Set to false to disable.

Default
true
Value
true
SCAN_INTERVAL_HOURSVariable

Hours between automatic scans. Accepts decimals (0.5 = 30 min). Set to 0 to disable.

Default
6
Value
6
SCAN_ON_STARTVariable

Run an initial scan immediately when the container starts.

Default
true
Value
true
SCAN_CRON_EXPRESSIONVariable

Optional: override with a custom cron expression (e.g. '0 3 * * *' for 3am daily). Leave empty to use SCAN_INTERVAL_HOURS.

TREEMAP_MAX_NODESVariable

Maximum number of items to render in the treemap.

Default
20000
Value
20000
TREEMAP_MAX_DEPTHVariable

Maximum folder depth to display in the treemap.

Default
5
Value
5
TREEMAP_LIGHT_THRESHOLDVariable

Item count below which no filtering is applied.

Default
5000
Value
5000
TREEMAP_MODERATE_THRESHOLDVariable

Item count threshold for moderate filtering.

Default
15000
Value
15000
TREEMAP_AGGRESSIVE_THRESHOLDVariable

Item count threshold for aggressive filtering.

Default
50000
Value
50000
WebUIPorttcp

Port for the web interface.

Target
3000
Default
3455
Value
3455

Details

Repository
ghcr.io/unknowncall/storyscan:latest
Last Updated2026-05-31
First Seen2025-11-09

Run StoryScan on Unraid.

StoryScan is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.