About duf
duf shows filesystem usage in a clean table format with color coding and human-readable units. Filters allow focusing on specific disks or storage types.
Key features
- 01Display filesystem usage in readable formatted tables
- 02Color-coded output with smart unit conversion
- 03Filter by storage type to focus on local or specific mounts
Use cases
- 01Quickly check overall disk capacity and free space
- 02Monitor usage across multiple disks or mount points
- 03Capture disk status snapshots in monitoring or automation scripts
Install
Pick your OS or package manager and run the command in a terminal.
Once installed, runduf --versionto confirm it works.
Example commands
Common commands in the order you’d use them.
Details
From the project READMEduf
Disk Usage/Free Utility (Linux, BSD, macOS & Windows)
Features
- User-friendly, colorful output
- Adjusts to your terminal's theme & width
- Sort the results according to your needs
- Groups & filters devices
- 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
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 or drop me a note!