flox build update catalogs command
NAME
flox-build-update-catalogs - Update catalog lockfile for Nix expression builds
SYNOPSIS
flox [<general-options>] build update-catalogs
[-d=<path>]
DESCRIPTION
Read the catalog configuration from .flox/nix-builds.toml and generate
(or regenerate) the lockfile at .flox/nix-builds.lock.
Each catalog entry in nix-builds.toml is
resolved and pinned: Nix source-type catalogs are locked with
nix flake prefetch, and FloxHub catalogs are locked against the
FloxHub API. The resulting lockfile pins every catalog to a specific
revision, ensuring reproducible builds.
Both .flox/nix-builds.toml and .flox/nix-builds.lock should be
committed to version control so that all collaborators build against
identical catalog inputs.
This command only works with path (local) environments. It cannot be used with managed or remote environments.
If no .flox/nix-builds.toml file exists, the command prints a warning
with the expected file path and exits without error.
OPTIONS
Environment Options
If no environment is specified for an environment command, the environment in the current directory or the active environment that was last activated is used.
-d, --dir
Path containing a .flox/ directory.
General Options
-h, --help
Prints help information.
The following options can be passed when running any flox subcommand
but must be specified before the subcommand.
-v, --verbose
Increase logging verbosity. Invoke multiple times for increasing detail.
-q, --quiet
Silence logs except for errors.
EXAMPLES
Lock catalog inputs
$ flox build update-catalogs