---
name: "duf"
section: "1"
platform: "linux"
package: "duf"
version: "0.9.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/duf"
---

# duf(1)

Disk Usage/Free Utility

## NAME

duf - Disk Usage/Free Utility

## SYNOPSIS

**duf** \[*options...*\] \[*argument...*\]

## DESCRIPTION

Simple Disk Usage/Free Utility.

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.

## OPTIONS

- **-all**

  include pseudo, duplicate, inaccessible file systems

- **-avail-threshold**

  specifies the coloring threshold (yellow, red) of the avail column, must be integer with optional SI prefixes

- **-hide**

  hide specific devices, separated with commas: local, network, fuse, special, loops, binds

- **-hide-fs**

  hide specific filesystems, separated with commas

- **-hide-mp**

  hide specific mount points, separated with commas (supports wildcards)

- **-inodes**

  list inode information instead of block usage

- **-json**

  output all devices in JSON format

- **-only**

  show only specific devices, separated with commas: local, network, fuse, special, loops, binds

- **-only-fs**

  only specific filesystems, separated with commas

- **-only-mp**

  only specific mount points, separated with commas (supports wildcards)

- **-output**

  output fields: mountpoint, size, used, avail, usage, inodes, inodes\_used, inodes\_avail, inodes\_usage, type, filesystem

- **-sort**

  sort output by: mountpoint, size, used, avail, usage, inodes, inodes\_used, inodes\_avail, inodes\_usage, type, filesystem

- **-style**

  style: unicode, ascii

- **-theme**

  color themes: dark, light, ansi

- **-usage-threshold**

  specifies the coloring threshold (yellow, red) of the usage bars as a floating point number from 0 to 1

- **-version**

  display version

- **-warnings**

  output all warnings to STDERR

- **-width**

  max output width

## 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

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/\*'

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

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"

If you prefer your output as JSON:

  $ duf --json

## NOTES

Portions of duf's code are copied and modified from https://github.com/shirou/gopsutil.

gopsutil was written by WAKAYAMA Shirou and is distributed under BSD-3-Clause.

## AUTHORS

duf was written by Christian Muehlhaeuser \<https://github.com/muesli/duf\>

## COPYRIGHT

Copyright (C) 2020-2022 Christian Muehlhaeuser \<https://github.com/muesli\>

Released under MIT license.