command: docker buildx prune
short: Remove build cache
long: |-
    Clears the build cache of the selected builder.

    You can finely control what cache data is kept using:

    - The `--filter=until=<duration>` flag to keep images that have been used in
      the last `<duration>` time.

      `<duration>` is a duration string, e.g. `24h` or `2h30m`, with allowable
      units of `(h)ours`, `(m)inutes` and `(s)econds`.

    - The `--keep-storage=<size>` flag to keep `<size>` bytes of data in the cache.

      `<size>` is a human-readable memory string, e.g. `128mb`, `2gb`, etc. Units
      are case-insensitive.

    - The `--all` flag to allow clearing internal helper images and frontend images
      set using the `#syntax=` directive or the `BUILDKIT_SYNTAX` build argument.
usage: docker buildx prune
pname: docker buildx
plink: docker_buildx.yaml
options:
    - option: all
      shorthand: a
      value_type: bool
      default_value: "false"
      description: Include internal/frontend images
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: filter
      value_type: filter
      description: Provide filter values (e.g., `until=24h`)
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: force
      shorthand: f
      value_type: bool
      default_value: "false"
      description: Do not prompt for confirmation
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: keep-storage
      value_type: bytes
      default_value: "0"
      description: Amount of disk space to keep for cache
      deprecated: true
      hidden: true
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: max-used-space
      value_type: bytes
      default_value: "0"
      description: Maximum amount of disk space allowed to keep for cache
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: min-free-space
      value_type: bytes
      default_value: "0"
      description: Target amount of free disk space after pruning
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: reserved-space
      value_type: bytes
      default_value: "0"
      description: Amount of disk space always allowed to keep for cache
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: verbose
      value_type: bool
      default_value: "false"
      description: Provide a more verbose output
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
inherited_options:
    - option: builder
      value_type: string
      description: Override the configured builder instance
      details_url: '#builder'
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: debug
      shorthand: D
      value_type: bool
      default_value: "false"
      description: Enable debug logging
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
examples: |-
    ### Override the configured builder instance (--builder) {#builder}

    Same as [`buildx --builder`](/reference/cli/docker/buildx/#builder).
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false