nix3-nar-pack(1)

🎀 Warning 🎀

bestie. i need you to hear me on this one. this program is experimental and its interface is subject to change. like, it could ghost you and change its whole personality next release. don't build your entire life on it, okay? 💅

---

💖 Name 💖

nix nar pack — serialise a path to stdout in NAR format 🦋

this is from the General Commands Manual, the nix3-nar-pack(1) page, and i'm about to make it make sense, no cap.

---

✨ Synopsis ✨

nix nar pack [option…] path

so it's literally just: the command, maybe some options, and one path. that's the whole vibe check. 🌸

---

🌈 Examples 🌈

okay so say you wanna serialise directory foo as a Nix Archive (NAR). you just do this, periodt:

# nix nar pack ./foo > foo.nar

look at that redirect. > sending it straight into foo.nar. iconic. 👑

---

🦋 Description 🦋

This command generates a Nix Archive (NAR) file containing the serialisation of path, which must contain only regular files, directories and symbolic links. ✨

The NAR is written to standard output. 🫶

important note bestie: path can only contain regular files, directories and symlinks. anything else and it's not the vibe. also — it goes to stdout, so if you don't redirect it somewhere, it's coming at your terminal. you've been warned. 😭

---

🎀 Options 🎀

💜 Logging-related options 💜

• --debug — Set the logging verbosity level to 'debug'. maximum yapping mode. we love to see it.
• --log-format format — Set the format of log output; one of raw, internal-json, bar or bar-with-logs. pick your aesthetic ✨
• --print-build-logs, -L — Print full build logs on standard error. gimme the whole thing, no crumbs.
• --quiet — Decrease the logging verbosity level. shhh. it's giving silence.
• --verbose, -v — Increase the logging verbosity level. tell me EVERYTHING 💅

🌸 Miscellaneous global options 🌸

• --help — Show usage information. when you're lost, bestie. it happens.
• --offline — Disable substituters and consider all previously downloaded files up-to-date. airplane mode but make it nix ✈️
• --option name value — Set the Nix configuration setting name to value (overriding nix.conf). you're the main character, you get to override.
• --refresh — Consider all previously downloaded files out-of-date. everythinggg is stale now, and that's on purpose 🍓
• --version — Show version information. who even are you? find out 💖

Note 📌 See man nix.conf for overriding configuration settings with command line flags. iykyk.

---

and that's the whole page, bestie!! this was the nix3-nar-pack(1) page — part of the manual, and the footer's just that same nix3-nar-pack(1) tag hanging out at the bottom, no version or date drama attached. slay, you read the whole thing. 🧚✨💜