`flox push` command¶

NAME¶

flox-push -

SYNOPSIS¶

flox [ <general-options> ] push [ <options> ] [ --force ] [ ( -m | --main ) ]

DESCRIPTION¶

(git) Push metadata to the environment’s floxmeta repository. With this mechanism environments can be pushed and pulled between machines and within teams just as you would any project managed with git.

With the (-m|\--main) argument flox (push|pull) will operate on the “floxmain” branch, pushing user metadata to the upstream repository. Cannot be used in conjunction with the -e|\--environment flag.

With the --force argument flox will forceably overwrite either the upstream or local copy of the environment based on having invoked push or pull, respectively.

OPTIONS¶

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
Debug mode. Invoke multiple times for increasing detail.

-V, --version
Print flox version.

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

--bash-passthru
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.

Push Options¶

[ (-m | --main ) ]
operate on the “floxmain” branch, push user metadata to the upstream repository. Cannot be used in conjunction with the -e|--environment flag.

[ --force ]
forceably overwrite the upstream copy of the environment

flox push command¶