+0
Daily
15,385
stars
476
forks
84
watchers
228
prs
147
issues
14
releases
README
duf
Disk Usage/Free Utility (Linux, BSD, macOS & Windows)
!duf
Features
- [x] User-friendly, colorful output
- [x] Adjusts to your terminal's theme & width
- [x] Sort the results according to your needs
- [x] Groups & filters devices
- [x] Can conveniently output JSON
Installation
Packages
Linux
- Arch Linux: pacman -S duf
- Ubuntu (22.04 and later) / Debian (12 and later): apt install duf
- Fedora Linux: dnf install duf
- Nix: nix-env -iA nixpkgs.duf
- Void Linux: xbps-install -S duf
- Gentoo Linux: emerge sys-fs/duf
- Solus: eopkg it duf
- Packages in Alpine, Debian & RPM formats
BSD
- FreeBSD: pkg install duf
- OpenBSD: pkg_add duf
macOS
- with Homebrew: brew install duf
- with MacPorts: sudo port selfupdate && sudo port install duf
Windows
- with Chocolatey: choco install duf
- with scoop: scoop install duf
Android
- Android (via termux): pkg install duf
Binaries
- Binaries for Linux, FreeBSD, OpenBSD, macOS, Windows
From source
Make sure you have a working Go environment (Go 1.23 or higher is required).
See the install instructions.
Compiling duf is easy, simply run:
git clone https://github.com/muesli/duf.git
cd duf
go build
Usage
You can simply start duf without any command-line arguments:
duf
If you supply arguments, duf will only list specific devices & mount points:
duf /home /some/file
If you want to list everything (including pseudo, duplicate, inaccessible file systems):
duf --all
Filtering
You can show and hide specific tables:
duf --only local,network,fuse,special,loops,binds
duf --hide local,network,fuse,special,loops,binds
You can also show and hide specific filesystems:
duf --only-fs tmpfs,vfat
duf --hide-fs tmpfs,vfat
...or specific mount points:
duf --only-mp /,/home,/dev
duf --hide-mp /,/home,/dev
Wildcards inside quotes work:
duf --only-mp '/sys/,/dev/'
Display options
Sort the output:
duf --sort size
Valid keys are: mountpoint, size, used, avail, usage, inodes,
inodes_used, inodes_avail, inodes_usage, type, filesystem.
Show or hide specific columns:
duf --output mountpoint,size,usage
Valid keys are: mountpoint, size, used, avail, usage, inodes,
inodes_used, inodes_avail, inodes_usage, type, filesystem.
List inode information instead of block usage:
duf --inodes
If duf doesn't detect your terminal's colors correctly, you can set a theme:
duf --theme light
Color-coding & Thresholds
duf highlights the availability & usage columns in red, green, or yellow,
depending on how much space is still available. You can set your own thresholds:
duf --avail-threshold="10G,1G"
duf --usage-threshold="0.5,0.9"
Bonus
If you prefer your output as JSON:
duf --json
Troubleshooting
Users of oh-my-zsh should be aware that it already defines an alias called
duf, which you will have to remove in order to use duf:
unalias duf
Feedback
Got some feedback or suggestions? Please open an issue orTop issues
#318Unicode print style activated as default with too much colored area11 comments · 2025-09-08#141feature request: stay "open" and autorefresh like htop9 comments · 2021-10-19#46Bind mounts should be in the list of special devices9 comments · 2020-09-30#99sshfs volume listed with incorrect statistics7 comments · 2020-12-21#240incorrect information wrt used and free: 6 comments · 2023-04-13#136Small drives are shown in red even when there is plenty of space6 comments · 2021-09-10#361The output of the new DUF version is not aesthetically pleasing5 comments · 2026-03-02#274macOS – Does not hide “/System/Volumes” Mount Points5 comments · 2024-02-16
Discussions
Latest release
v0.9.1 v0.9.1 2025-09-08Changelog 2f48dc59d3f7259048817cab4471b419b0aab49d fix: allow manually supplying version/commit again 959c8e18e248a63fbc64e4bd2520e8276a79de70 fix: include version number in tarballs b2f01a1ecbfd1af63015b83296c50a95260f97b1 fix: parse modified git tree flag correctly