Gdu Web is a read-only, on-demand storage analyzer for Windows with a local web interface. It combines a Go scanner and an embedded React application in one executable, so a browser on the local network can start, observe, cancel, and explore scans without launching a separate desktop analyzer.
Gdu Web was inspired by gdu, but uses its own scanner implementation. It is an independent project and is not affiliated with the gdu maintainers.
Gdu Web is an early Windows-first project. The latest packaged release is
v0.1.0, built for 64-bit
Windows. The main branch contains later development changes described in the
changelog.
The current release supports manual scans of administrator-configured roots, live progress and cancellation, exploration of the resulting tree, and reuse of the latest cached result after restart. It deliberately has no deletion controls, scheduling, scan history, arbitrary path entry, application login, or internet-facing deployment. The scanner walks the filesystem and does not yet parse the NTFS MFT.
Download and extract the latest ZIP from
GitHub Releases. Before
installing, edit config.example.yaml in the extracted directory so its
roots list contains only the drives or directories the service should be
allowed to scan.
Open an elevated PowerShell prompt in the extracted directory and run:
Set-ExecutionPolicy -Scope Process Bypass
.\scripts\install-windows.ps1The installer copies the executable and configuration, registers the GduWeb
Windows service, and creates a Private-profile firewall rule limited to the
local subnet. Open http://HOSTNAME:8765 from the Windows host or another
device on that trusted network.
See Windows installation and operations for installed file locations, service commands, and troubleshooting.
- Open the web interface at
http://HOSTNAME:8765. - Choose one of the roots allowed by the administrator configuration.
- Start the scan and watch its item count, size totals, warnings, and elapsed time. A running scan can be cancelled.
- Explore the directory tree after completion. Gdu Web stores only the latest successful result so it remains available after a service restart.
Inaccessible paths appear as warnings instead of discarding the previous result.
The installed service reads:
C:\ProgramData\GduWeb\config.yaml
Only roots listed in that file can be scanned. The browser API does not accept
raw filesystem paths. Restart the GduWeb service after changing the file.
Contributor requirements: Go 1.24 or newer and Node.js 22 or newer.
cd ui
npm install
npm test
npm run build
cd ..
go test ./...
make build-windowsThe 64-bit Windows release payload is written to dist/.
See the Roadmap, Architecture, and Windows installation and operations for planned work, implementation details, and service operations.
- Utilities:
- Gdu Web:
icon: mdi-harddisk
href: http://HOSTNAME:8765
description: Explore disk usageV1 trusts the local network and has no application login. Keep the Windows
network profile Private, retain the LocalSubnet firewall restriction, and do
not create router port forwarding. Scan roots are administrator-controlled.
From an elevated PowerShell prompt in an extracted release, run:
.\scripts\uninstall-windows.ps1This retains configuration and the cached scan. Add -RemoveData to delete
them too.
One July 2026 full-drive validation run under the Windows LocalSystem account
completed in about 81 seconds and peaked at 1.62 GB of working memory. A rescan
while retaining the previous cached tree peaked briefly at 2.19 GB during
compressed-cache finalization. These are results from one test machine and
dataset, not a general performance guarantee.
The reproducible service benchmark is
scripts/benchmark-service-windows.ps1.
It records duration, item count, logical and allocated sizes, warning count,
and peak working memory while enforcing configurable time and memory gates.