Manpages - nix3-profile-install.1
Warning
This program is experimental and its interface is subject to change.
#+end_quote
Name
nix profile install
- install a package into a profile
Synopsis
nix profile install
[/option/…] installables…
Examples
- Install a package from Nixpkgs:
# nix profile install nixpkgs#hello
- Install a package from a specific branch of Nixpkgs:
# nix profile install nixpkgs/release-20.09#hello
- Install a package from a specific revision of Nixpkgs:
# nix profile install nixpkgs/d73407e8e6002646acfdef0e39ace088bacc83da#hello
- Install a specific output of a package:
# nix profile install nixpkgs#bash^man
Description
This command adds installables to a Nix profile.
Options
--priority
priority The priority of the package to install.--profile
path The profile to operate on.--stdin
Read installables from the standard input. No default installable applied.
Common evaluation options
--arg
name expr Pass the value expr as the argument name to Nix functions.--arg-from-file
name path Pass the contents of file path as the argument name to Nix functions.--arg-from-stdin
name Pass the contents of stdin as the argument name to Nix functions.--argstr
name string Pass the string string as the argument name to Nix functions.--debugger
Start an interactive environment if evaluation fails.--eval-store
store-url The URL of the Nix store to use for evaluation, i.e. to store derivations (.drv
files) and inputs referenced by them.--impure
Allow access to mutable paths and repositories.--include
/-I
path Add path to search path entries used to resolve lookup paths This option may be given multiple times. Paths added through-I
take precedence over thenix-path
configuration setting and theNIX_PATH
environment variable.--override-flake
original-ref resolved-ref Override the flake registries, redirecting original-ref to resolved-ref.
Common flake-related options
--commit-lock-file
Commit changes to the flake's lock file.--inputs-from
flake-url Use the inputs of the specified flake as registry entries.-
--no-registries
Don't allow lookups in the flake registries.
DEPRECATED
Use
--no-use-registries
instead. --no-update-lock-file
Do not allow any updates to the flake's lock file.--no-write-lock-file
Do not write the flake's newly generated lock file.--output-lock-file
flake-lock-path Write the given lock file instead offlake.lock
within the top-level flake.--override-input
input-path flake-url Override a specific flake input (e.g.dwarffs/nixpkgs
). This implies--no-write-lock-file
.-
--recreate-lock-file
Recreate the flake's lock file from scratch.
DEPRECATED
Use
nix flake update
instead. --reference-lock-file
flake-lock-path Read the given lock file instead offlake.lock
within the top-level flake.-
--update-input
input-pathUpdate a specific flake input (ignoring its previous entry in the lock file).
DEPRECATED
Use
nix flake update
instead.
Logging-related options
--debug
Set the logging verbosity level to ‘debug'.--log-format
format Set the format of log output; one ofraw
,internal-json
,bar
orbar-with-logs
.--print-build-logs
/-L
Print full build logs on standard error.--quiet
Decrease the logging verbosity level.--verbose
/-v
Increase the logging verbosity level.
Miscellaneous global options
--help
Show usage information.--offline
Disable substituters and consider all previously downloaded files up-to-date.--option
name value Set the Nix configuration setting name to value (overridingnix.conf
).--refresh
Consider all previously downloaded files out-of-date.--repair
During evaluation, rewrite missing or corrupted files in the Nix store. During building, rebuild missing or corrupted store paths.--version
Show version information.
Options that change the interpretation of installables
--expr
expr Interpret installables as attribute paths relative to the Nix expression expr.--file
/-f
file Interpret installables as attribute paths relative to the Nix expression stored in file. If file is the character -, then a Nix expression will be read from standard input. Implies--impure
. Note Seeman nix.conf
for overriding configuration settings with command line flags.