Manpages - nix3-flake-new.1
Warning
This program is experimental and its interface is subject to change.
#+end_quote
Name
nix flake new - create a flake in the specified directory from a
template
Synopsis
nix flake new [/option/…] dest-dir
Examples
- Create a flake using the default template in the directory
hello:
# nix flake new hello
- List available templates:
# nix flake show templates
- Create a flake from a specific template in the directory
hello:
# nix flake new hello -t templates#trivial
Description
This command creates a flake in the directory dest-dir, which must not
already exist. It's equivalent to:
# mkdir dest-dir # cd dest-dir # nix flake init
Options
--template/-ttemplate The template to use.
Common evaluation options
--argname expr Pass the value expr as the argument name to Nix functions.--arg-from-filename path Pass the contents of file path as the argument name to Nix functions.--arg-from-stdinname Pass the contents of stdin as the argument name to Nix functions.--argstrname string Pass the string string as the argument name to Nix functions.--debuggerStart an interactive environment if evaluation fails.--eval-storestore-url The URL of the Nix store to use for evaluation, i.e. to store derivations (.drvfiles) and inputs referenced by them.--impureAllow access to mutable paths and repositories.--include/-Ipath Add path to search path entries used to resolve lookup paths This option may be given multiple times. Paths added through-Itake precedence over thenix-pathconfiguration setting and theNIX_PATHenvironment variable.--override-flakeoriginal-ref resolved-ref Override the flake registries, redirecting original-ref to resolved-ref.
Logging-related options
--debugSet the logging verbosity level to ‘debug'.--log-formatformat Set the format of log output; one ofraw,internal-json,barorbar-with-logs.--print-build-logs/-LPrint full build logs on standard error.--quietDecrease the logging verbosity level.--verbose/-vIncrease the logging verbosity level.
Miscellaneous global options
--helpShow usage information.--offlineDisable substituters and consider all previously downloaded files up-to-date.--optionname value Set the Nix configuration setting name to value (overridingnix.conf).--refreshConsider all previously downloaded files out-of-date.--repairDuring evaluation, rewrite missing or corrupted files in the Nix store. During building, rebuild missing or corrupted store paths.--versionShow version information. Note Seeman nix.conffor overriding configuration settings with command line flags.