Skip to content

flox wipe-history command


flox-wipe-history - delete builds of non-current versions of an environment

flox [ <general-options> ] wipe-history [ <options> ]


Environment generations are composed of: - a human editable description (which can be modified with flox-edit(1)) - a build of that description, which includes all the binaries that are part of the environment

wipe-history cleans up old builds of an environment, but it does not delete the description of generations, so they can still be switched to with flox-rollback(1). wipe-history always keeps the 10 most recent generations, and it only deletes generations that have not been created or switched to for more than 90 days. In the process, a garbage collection of the entirety of /nix/store is triggered.


General Options

Many flox commands wrap Nix commands of the same name, and will correspondingly pass on options and arguments directly to the underlying nix invocation. For more information on the options supported by specific Nix commands please invoke flox nix <command> help.

The following options are used specifically by flox and must be specified before the <command> argument.

-v, --verbose
Verbose mode. Invoke multiple times for increasing detail.

Debug mode. Invoke multiple times for increasing detail.

-V, --version
Print flox version.

Print flox installation prefix / Nix store path. (flox internal use only.)

Force execution in flox-bash (flox internal use only.)

Environment Options

The following option is supported by environment commands:

(-e|–environment) <name>
Selects flox environment to be modified or used. If not provided then flox will fall back to using the default environment.