OS Manuals

/usr/bin/dua

View disk space usage and delete unwanted data, fast.

From dua 3.0.1-r0 (os), captured 2026-11-10 by running dua --help (exit 0). permalink

A tool to learn about disk usage, fast!

Usage: dua [FLAGS] [OPTIONS] [SUBCOMMAND] [INPUT]...

Commands:
  clean        Find disposable directories and inspect them in the terminal user interface
  interactive  Launch the terminal user interface [aliases: i]
  diff         Compare two traversal snapshots
  stacks       Print folded stacks for flame-graph tools
  flamegraph   Render disk usage as an SVG flame graph
  aggregate    Aggregate the consumed space of one or more directories or files [aliases: a]
  completions  Generate shell completions
  config       Configuration related commands
  help         Print this message or the help of the given subcommand(s)

Arguments:
  [INPUT]...
          One or more input files or directories. If unset, we will use all entries in the current working directory

Options:
      --log-file <LOG_FILE>
          Write a log file with debug information, including panics

          [env: DUA_LOG_FILE=]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

Traversal Options:
  -t, --threads <THREADS>
          The number of threads to use. Defaults to 8 on macOS and 0 elsewhere. Set to 0 to use the number of logical processors, or 1 to use a single thread

          [env: DUA_THREADS=]
          [default: 0]

  -A, --apparent-size
          Display apparent size instead of disk usage

          [env: DUA_APPARENT_SIZE=]

  -l, --count-hard-links
          Count hard-linked files each time they are seen

          [env: DUA_COUNT_HARD_LINKS=]

  -x, --stay-on-filesystem
          If set, we will not cross filesystems or traverse mount points

          [env: DUA_STAY_ON_FILESYSTEM=]

  -i, --ignore-dirs <IGNORE_DIRS>
          One or more absolute directories to ignore. Note that these are not ignored if they are passed as input path.

          Hence, they will only be ignored if they are eventually reached as part of the traversal.

          [env: DUA_IGNORE_DIRS=]
          [default: /proc /dev /sys /run]

      --ignore-from <FILE>
          One or more files with gitignore-style patterns, whose matches are left out of the report.

          Patterns follow `.gitignore` syntax - `#` starts a comment, a trailing `/` matches directories only, a leading `/` anchors to the top, `**` spans directories, and `!` re-includes what an earlier pattern excluded. They are case-sensitively on all platforms.

          Files given later take precedence over files given earlier. Excluded directories are not descended into, so their contents cannot be re-included.

          [env: DUA_IGNORE_FROM=]

  -f, --format <FORMAT>
          The format with which to print byte counts

          [env: DUA_FORMAT=]
          [possible values: metric, binary, bytes, gb, gib, mb, mib]
Options (10)
OptionDescriptionSource
--log-file LOG_FILEWrite a log file with debug information, including panicshelp
-h, --helpPrint help (see a summary with '-h')help
-V, --versionPrint versionhelp
-t, --threads THREADSThe number of threads to use.help
-A, --apparent-sizeDisplay apparent size instead of disk usagehelp
-l, --count-hard-linksCount hard-linked files each time they are seenhelp
-x, --stay-on-filesystemIf set, we will not cross filesystems or traverse mount pointshelp
-i, --ignore-dirs IGNORE_DIRSOne or more absolute directories to ignore.help
--ignore-from FILEOne or more files with gitignore-style patterns, whose matches are left out of the report.help
-f, --format FORMATThe format with which to print byte countshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.