NIXTAMAL-SET-UP(1)

nixtamal-set-up - Set up working directory for Nixtamal. By default, also adds Nixpkgs from upstream to the project's inputs.

nixtamal set-up [OPTION]…

GNU General Public License, version 3.0 later (GPL-3.0-or-later)

toastal <https://toast.al/contact/>

See: https://toast.al/funding/

Make a complete project structure based on a blueprint to give a starting off point to build on.
Colorize the output. WHEN must be one of auto, always or never.
Working directory for Nixtamal-related files (default: $PWD/nix/tamal)
The default fetch time to be used for inputs.
The default algorithm to be used for inputs & patches.
Nixtamal’s executor pool domain size.
Nixpkgs Git channel for Nixtamal setup (such as “nixpkgs-unstable”). Both --nixpkgs-channel & --nixpkgs-ref cannot be used at the same time.
Nixpkgs Git ref for Nixtamal setup (such as “refs/heads/nixos-25.11”; default: refs/heads/nixos-unstable). Both --nixpkgs-channel & --nixpkgs-ref cannot be used at the same time.
Nixpkgs Git revision for Nixtamal setup. The value will be used as the latest revision/change.
Do not add Nixpkgs to the pinned inputs list by default.
Be quiet. Takes over -v and --verbosity.
Channels are more efficient being compressed with LZMA instead of gzip, doesn’t rely on US megacorpations, & would be recommend — however, the syntax for this setup is less intuitive/portable to users while also not providing a clear template for Git archives to be remixed for other inputs making it not the default for newcomers.
For resilience, add known Nixpkgs Git mirrors to fallback on when the Nixpkgs’s Microsoft GitHub host inevitably goes down again. Off by default as the Git updating is slightly slower & some users might object to TUNA’s hosting origin state.
Increase verbosity. Repeatable, but more than twice does not bring more.
VCS for ignore file setup.
Be more or less verbose. LEVEL must be one of quiet, error, warning, info or debug. Takes over -v.

Show this help in format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined.
Show version information.

nixtamal set-up exits with:

0
on success.
65
Nixtamal working directory or manifest not set up. Run `nixtamal set-up`.
66
Version mismatch between manifest and lockfile. Run `nixtamal lock`, but might require *removing* the lockfile first until `nixtaml fast-forward` is made.
67
Manifest ∨ lockfile is not using the latest schema version. Run `nixtamal upgrade` to upgrade.
68
Failed to parse the manifest file.
69
Failed to parse the lockfile.
70
Failed to serialize lockfile.
71
Fresh command execution threw an exception.
72
Fresh command output nothing.
73
Prefetch command threw an exception.
74
Prefetch command output was unusable.
75
Prefetch command flopped on JSON output.
76
Darcs context file is missing or invalid. Try running `nixtamal lock` on the input.
77
Silo error (such as bad hex in generation number).
78
Version not found or invalid in manifest file.
79
Upgrading Nixtamal failed.
80
BLAKE3 hash algorithm is requested but this Nix doesn’t support it.
81
Input kind mismatch between manifest & lockfile which prevents values to be melded.
82
Blueprint scaffolding failed to write files.
123
on indiscriminate errors reported on standard error.
124
on command line parsing errors.
125
on unexpected internal errors (bugs).

These environment variables affect the execution of nixtamal set-up:

Directory for Nixtamal
See option --jobs.
See option --verbosity.
See option --nixpkgs-channel.
See option --nixpkgs-ref.
See option --nixpkgs-revision.
See option --no-nixpkgs.
See option --color.
See option --use-channels.
See option --use-nixpkgs-git-mirrors.

No tracker is set up; contact the maker directly or join the XMPP chatroom @ <xmpp:nixtamal@chat.toastal.in.th?join>.

fulfilling input pinning for Nix
manifest.kdl format

nixtamal(1)

Nixtamal 1.9.2