Skip to content

Getting started

mish answers one question fast: where did my disk space go? It scans and indexes filesystems into an immutable snapshot, then serves an interactive web client and a JSON-first CLI.

Terminal window
docker compose up -d --build

The compose file publishes on loopback by default, mounts a GET-only docker-socket-proxy, and runs the app as an unprivileged user. The container binds 0.0.0.0:9543 so Docker can forward the port, so the first visit asks for the generated API token:

Terminal window
docker compose exec mish cat /data/auth-token

Set MISH_AUTH_TOKEN to choose your own. For LAN access also set MISH_ALLOWED_HOSTS; see Security.

Open the web client and press Scan, or use the API. Roots must be inside MISH_ROOTS (the default is /host):

Terminal window
curl -s -X POST http://localhost:9543/api/v1/scans \
-H 'content-type: application/json' \
-d '{"roots":["/host/etc"]}'

If MISH_AUTH_TOKEN is set, add -H "Authorization: Bearer $MISH_AUTH_TOKEN".

  • Treemap — area is size; click a rectangle to drill in.
  • Sunburst / Icicle / Bubble — other reads on the same hierarchy.
  • Bars / Histogram / Extensions / Age / Owners — ranked and aggregated views.
  • Docker — per-container size, mounts and live stats.
  • Duplicates / Diff — cleanup candidates and growth between two snapshots.