QDirStat

QDirStat is a cross-platform directory statistics tool that visualises disk usage through a tree view, a colour-coded treemap, and a details panel, helping…

  • Home Automation
  • Productivity
  • Tools & Utilities
QDirStat is a cross-platform directory statistics tool that visualises disk usage through a tree view, a colour-coded treemap, and a details panel, helping you locate and remove large or unnecessary files. This Docker image delivers the Qt-based graphical interface through a web browser or any VNC client with no client-side installation required, and runs on an Alpine Linux base for minimal resource consumption on home-lab and server systems.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

67/100 Good

Maintained
97last commit 60 days ago
Popular
3882 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
66no serious findings, tests, OpenSSF Scorecard 3.8/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
82
Open issues
0
Last commit
2026-09-22
Latest release
v26.09.1
License
MIT
Activity
stale

Checked 12 days ago - source: GitHub (jlesage/docker-qdirstat)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Let the scan see all files When scanning a mounted drive or another user's folders, run QDirStat with admin rights, for example: sudo qdirstat /path/to/folder. Without that, it may skip hidden files or folders it is not allowed to read, so the size totals can be wrong. source
  • Don't hand-edit cache files If QDirStat saves a cache file for faster re-scans, keep it but do not edit it by hand. Manual changes can confuse the file format and make the tool show wrong folder sizes or stale results. source
  • Use slow-update for big folders For very large folders or remote shares, start the scan with the slow-update option, for example: qdirstat --slow-update /path/to/folder. This gives it a longer pause between updates, which is friendlier when the scan source is slow and can make the program feel stuck at the default pace. source
  • First run: access the interface Open the app in a web browser at the configured port, or connect with a VNC client. The GUI is delivered over the network, so there is nothing to install on the client. source

Fetched 15 days ago - each note links to its source

Alternatives (11)

  • Baobab Disk Usage Analyzer - Graphical GNOME application that analyzes disk usage with detailed graphical representation, supporting scans of both local and remote dire…
  • DaisyDisk - Visually analyzes disk space with an interactive sunburst map, identifies and previews large files, and enables efficient removal to reclai…
  • DiskUsage - DiskUsage provides a way to find out which files and directories on the SD card of your Android phone are consuming the most space.
  • Filelight - Displays disk usage visually with interactive segmented rings, scans local and remote disks, allows direct file management, and integrates…
  • GrandPerspective - GrandPerspective is a small utility application for Mac that graphically shows the disk usage within a file system.
  • Mole - Native Mac cleanup toolkit: free open-source CLI plus a $19 Mac app for cleaning, uninstalls, disk maps, and live status, always preview be…
  • SD Maid SE - SD Maid SE (aka SD Maid 2) is a file management tool for Android that specialises in maintenance.
  • TreeSize - Analyze disk space usage with in-depth insights and interactive visualizations across local and network drives, including mobile devices.
  • WinDirStat - Disk analysis tool with treemap views, duplicate file detection, and cleanup actions.
  • WizTree - Ultra-fast disk space analyzer for Windows, showing largest files and folders according to space usage by utilizing the NTFS file system's…
  • ncdu - Ncdu is a disk usage analyzer that displays directory sizes in a terminal interface, helping server and homelab administrators locate large…

Checked 51 days ago - source: AlternativeTo

Common questions

Can the GUI be used on a separate machine while the data is collected on a server?

Yes. It can be used on a different machine, such as a desktop, with data collected by a Perl script on the server.

Why might it report a different disk usage total than a file manager?

On btrfs, it may not be able to read certain folders, such as @root, so its total can differ from what the file manager reports.

How does it handle deleting entire directories?

It does not copy entire directory trees to the trash. It tries to copy single files, and for larger items it follows the XDG trash specification.

Does it provide both a tree view and a treemap?

Yes. It shows directory and file sizes in a traditional tree view and in a colored treemap, with larger files displayed as larger rectangles.

Answers sourced from github.com, github.com, www.reddit.com, www.reddit.com

Community

Collected 48 days ago - public community threads