Flakes - Revision history

DHCP: style fixes

2026-07-16T07:12:29Z

style fixes

← Older revision		Revision as of 07:12, 16 July 2026
Line 72:		Line 72:

	<syntaxhighlight lang="shell">		<syntaxhighlight lang="shell">
	--experimental-features 'nix-command flakes'		--experimental-features 'nix-command flakes'
	</syntaxhighlight>		</syntaxhighlight>

Line 85:		Line 85:

	<syntaxHighlight lang=nix>		<syntaxHighlight lang=nix>
	nix.settings.experimental-features = [ "nix-command" "flakes" ];		nix.settings.experimental-features = [ "nix-command" "flakes" ];
	</syntaxHighlight>		</syntaxHighlight>

Line 96:		Line 96:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	nix.settings.experimental-features = [ "nix-command" "flakes" ];		nix.settings.experimental-features = [ "nix-command" "flakes" ];
	</syntaxhighlight>		</syntaxhighlight>

Line 290:		Line 290:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	inputs.self.submodules = true;		inputs.self.submodules = true;
	</syntaxhighlight>		</syntaxhighlight>

Line 491:		Line 491:
	</translate>		</translate>

	<~~syntaxHighlight~~>		<syntaxhighlight lang=console>
	nix build github:nixos/nixpkgs?ref=pull/<PR_NUMBER>/head#<PACKAGE>		$ nix build github:nixos/nixpkgs?ref=pull/<PR_NUMBER>/head#<PACKAGE>
	</~~syntaxHighlight~~>		</syntaxhighlight>

	<translate>		<translate>
Line 503:		Line 503:
	</translate>		</translate>

	<~~syntaxHighlight~~>		<syntaxhighlight lang=console>
	git fetch upstream pull/<PR_NUMBER>/head && git checkout FETCH_HEAD && nix build .#PACKAGE		$ git fetch upstream pull/<PR_NUMBER>/head && git checkout FETCH_HEAD && nix build .#PACKAGE
	</~~syntaxHighlight~~>		</syntaxhighlight>

	<translate>		<translate>
Line 517:		Line 517:
	</translate>		</translate>

	<~~syntaxHighlight~~>		<syntaxhighlight lang=console>
	git add --intent-to-add extra/flake.nix		$ git add --intent-to-add extra/flake.nix
	git update-index --skip-worktree --assume-unchanged extra/flake.nix		$ git update-index --skip-worktree --assume-unchanged extra/flake.nix
	</~~syntaxHighlight~~>		</syntaxhighlight>

	<translate>		<translate>
Line 532:		Line 532:
	</translate>		</translate>

	<~~syntaxHighlight~~ lang=~~bash~~>		<syntaxhighlight lang=console>
	cd ~/libdep-src-checkout/		$ cd ~/libdep-src-checkout/
	nix develop # Or `nix-shell` if applicable.		$ nix develop # Or `nix-shell` if applicable.
	export prefix="./install" # configure nix to install it here		$ export prefix="./install" # configure nix to install it here
	buildPhase # build it like nix does		$ buildPhase # build it like nix does
	installPhase # install it like nix does		$ installPhase # install it like nix does
	</~~syntaxHighlight~~>		</syntaxhighlight>

	<translate>		<translate>
Line 545:		Line 545:
	</translate>		</translate>

	<~~syntaxHighlight~~ lang=~~bash~~>		<syntaxhighlight lang=console>
	cd ~/consumexe-src-checkout/		$ cd ~/consumexe-src-checkout/
	nix develop --redirect libdep ~/libdep-src-checkout/install		$ nix develop --redirect libdep ~/libdep-src-checkout/install
	echo $buildInputs \| tr " " "\n" \| grep libdep		$ echo $buildInputs \| tr " " "\n" \| grep libdep
	# Output should show ~/libdep-src-checkout/ so you know it worked		$ # Output should show ~/libdep-src-checkout/ so you know it worked
	</~~syntaxHighlight~~>		</syntaxhighlight>

	<translate>		<translate>

Toastal: Add a tip to avoid putting everything into the flake.nix for compatibility

2026-05-21T13:59:28Z

Add a tip to avoid putting everything into the flake.nix for compatibility

← Older revision		Revision as of 13:59, 21 May 2026
Line 469:		Line 469:
	<translate>		<translate>
	=== Flake support in projects without flakes === <!--T:50-->		=== Flake support in projects without flakes === <!--T:50-->

			{{Tip\|Consider building your project in a manner where the <code>flake.nix</code> is merely <code>import</code>ing or <code>callPackage</code>ing stable Nix code to maximize compatibility for everyone as well as avoiding adding workaround dependencies to your project}}

	<!--T:51-->		<!--T:51-->

DHCP: /* Enable unfree software */ fix formatting

2026-05-15T12:18:52Z

Enable unfree software: fix formatting

← Older revision		Revision as of 12:18, 15 May 2026
Line 439:		Line 439:
	let		let
	system = "x86_64-linux";		system = "x86_64-linux";
	pkgs = import nixpkgs { inherit system; config.allowUnfree = true;};		pkgs = import nixpkgs { inherit system; config.allowUnfree = true; };
	in {		in {
	...		...

DHCP: /* Defining_a_flake_for_multiple_architectures */ fix formatting in code block

2026-05-15T12:15:41Z

Defining_a_flake_for_multiple_architectures: fix formatting in code block

← Older revision		Revision as of 12:15, 15 May 2026
Line 397:		Line 397:
	description = "A flake targeting multiple architectures";		description = "A flake targeting multiple architectures";

	inputs = {		inputs = {
	nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";		nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
	};		};

	outputs = { self, nixpkgs }: let		outputs = { self, nixpkgs }: let
	systems = [ "x86_64-linux" "aarch64-linux" ];		systems = [ "x86_64-linux" "aarch64-linux" ];
	forAllSystems = f: builtins.listToAttrs (map (system: {		forAllSystems = f: builtins.listToAttrs (map (system: {
	name = system;		name = system;
	value = f system;		value = f system;
	}) systems);		}) systems);
	~~in {~~
	~~packages = forAllSystems (system: let~~
	~~pkgs = nixpkgs.legacyPackages.${system}~~;
	in {		in {
	hello = pkgs.hello;		packages = forAllSystems (system: let
	default = pkgs.hello;		pkgs = nixpkgs.legacyPackages.${system};
	});		in {
	};		hello = pkgs.hello;
			default = pkgs.hello;
			});
			};
	}		}
	</syntaxhighlight>		</syntaxhighlight>

DHCP: update links

2026-05-15T12:02:44Z

update links

← Older revision		Revision as of 12:02, 15 May 2026
Line 5:		Line 5:
	<translate>		<translate>
	<!--T:182-->		<!--T:182-->
	'''Nix flakes''' are an [https://nix.dev/manual/nix/stable/~~contributing~~/experimental-features experimental feature] first introduced in the 2.4 [[Nix]] release,{{Cite manual\|nix\|development/experimental-features\|number=13.8\|title=Experimental Features\|subsection=xp-feature-flakes\|subtitle=flakes}}{{Cite manual\|nix\|release-notes/rl-2.4\|number=14.27\|title=Release 2.4 (2021-11-01)}} aiming to address a number of areas of improvement for the Nix ecosystem: they provide a uniform structure for Nix projects, allow for pinning specific versions of each dependencies, and sharing these dependencies via lock files, and overall make it more convenient to write reproducible Nix expressions.		'''Nix flakes''' are an [https://nix.dev/manual/nix/stable/development/experimental-features experimental feature] first introduced in the 2.4 [[Nix]] release,{{Cite manual\|nix\|development/experimental-features\|number=13.8\|title=Experimental Features\|subsection=xp-feature-flakes\|subtitle=flakes}}{{Cite manual\|nix\|release-notes/rl-2.4\|number=14.27\|title=Release 2.4 (2021-11-01)}} aiming to address a number of areas of improvement for the Nix ecosystem: they provide a uniform structure for Nix projects, allow for pinning specific versions of each dependencies, and sharing these dependencies via lock files, and overall make it more convenient to write reproducible Nix expressions.

	<!--T:183-->		<!--T:183-->
Line 81:		Line 81:

	<!--T:8-->		<!--T:8-->
	Add the following to the [[~~Overview_of_the_NixOS_Linux_distribution#Declarative_Configuration~~ system configuration \|NixOS configuration]]:		Add the following to the [[NixOS system configuration#Usage\|NixOS configuration]]:
	</translate>		</translate>

Line 223:		Line 223:

	<!--T:149-->		<!--T:149-->
	* <code>nixConfig</code> is an attribute set of values which reflect the [https://~~nixos~~.~~org~~/manual/nix/stable/command-ref/conf-file.html values given to nix.conf]. This can extend the normal behavior of a user's nix experience by adding flake-specific configuration, such as a [[Binary Cache\|binary cache]].		* <code>nixConfig</code> is an attribute set of values which reflect the [https://nix.dev/manual/nix/stable/command-ref/conf-file.html values given to nix.conf]. This can extend the normal behavior of a user's nix experience by adding flake-specific configuration, such as a [[Binary Cache\|binary cache]].

	=== Input schema === <!--T:31-->		=== Input schema === <!--T:31-->

	<!--T:32-->		<!--T:32-->
	[https://~~nixos~~.~~org~~/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-inputs The nix flake inputs manual].		[https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-inputs The nix flake inputs manual].

	<!--T:150-->		<!--T:150-->
	[https://~~nixos~~.~~org~~/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-references The nix flake references manual].		[https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-flake.html#flake-references The nix flake references manual].

	<!--T:33-->		<!--T:33-->
Line 297:		Line 297:

	<!--T:151-->		<!--T:151-->
	The output schema is described the [https://nix.dev/manual/nix/~~2.33~~/command-ref/new-cli/nix3-flake-check.html#evaluation-checks nix flake check manual page].		The output schema is described the [https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-flake-check.html#evaluation-checks nix flake check manual page].

	<!--T:43-->		<!--T:43-->
Line 563:		Line 563:

	<!--T:176-->		<!--T:176-->
	* [https://~~nixos~~.~~org~~/manual/nix/~~unstable~~/command-ref/new-cli/nix3-flake.html Nix flake command reference manual] - Many additional details about flakes, and their parts.		* [https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-flake.html Nix flake command reference manual] - Many additional details about flakes, and their parts.

	<!--T:178-->		<!--T:178-->

DHCP: add missing "path:" line in the output of "nix flake show"

2026-05-15T11:47:17Z

add missing "path:" line in the output of "nix flake show"

← Older revision		Revision as of 11:47, 15 May 2026
Line 140:		Line 140:
	<syntaxhighlight lang="console">		<syntaxhighlight lang="console">
	$ nix flake show		$ nix flake show
			path:/path/to/flake
	└───packages		└───packages
	└───x86_64-linux		└───x86_64-linux
	├───default: package 'hello-2.12.2'		├───default: package 'hello-2.12.3'
	└───hello: package 'hello-2.12.2'		└───hello: package 'hello-2.12.3'
	</syntaxhighlight>		</syntaxhighlight>

DHCP: fix a few typos

2026-05-15T11:35:29Z

fix a few typos

← Older revision		Revision as of 11:35, 15 May 2026
Line 11:		Line 11:

	<!--T:184-->		<!--T:184-->
	Flakes also allow for locking references and versions, which can then be queried and updated ~~programatically~~ via the inputs {{cite manual\|nix\|command-ref/new-cli/nix3-flake-lock\|number=7.5.19\|title=nix flake lock}}{{cite manual\|nix\|command-ref/new-cli/nix3-flake-info\|number=7.5.17\|title=nix flake info}}. Additionally, an experimental CLI utility accepts flake references for expressions that build, run, and deploy packages.{{Cite manual\|nix\|command-ref/new-cli/nix\|number=8.5.1\|title=nix}}		Flakes also allow for locking references and versions, which can then be queried and updated programmatically via the inputs {{cite manual\|nix\|command-ref/new-cli/nix3-flake-lock\|number=7.5.19\|title=nix flake lock}}{{cite manual\|nix\|command-ref/new-cli/nix3-flake-info\|number=7.5.17\|title=nix flake info}}. Additionally, an experimental CLI utility accepts flake references for expressions that build, run, and deploy packages.{{Cite manual\|nix\|command-ref/new-cli/nix\|number=8.5.1\|title=nix}}

	== Flake file structure == <!--T:185-->		== Flake file structure == <!--T:185-->
Line 135:		Line 135:

	<!--T:194-->		<!--T:194-->
	This flake produces a single flake output <code>packages</code>. And within that, <code>x86_64-linux</code> is a system-~~specifc~~ attribute set. And within that, two package [[derivations]] <code>default</code> and <code>hello</code>. You can find outputs with the {{Nix Manual\|name=show command\|anchor=command-ref/new-cli/nix3-flake-show}} of a flake as shown below:		This flake produces a single flake output <code>packages</code>. And within that, <code>x86_64-linux</code> is a system-specific attribute set. And within that, two package [[derivations]] <code>default</code> and <code>hello</code>. You can find outputs with the {{Nix Manual\|name=show command\|anchor=command-ref/new-cli/nix3-flake-show}} of a flake as shown below:
	</translate>		</translate>

Averymt: Clarify when `nix flake init` can be used.

2026-05-03T06:51:46Z

Clarify when `nix flake init` can be used.

← Older revision		Revision as of 06:51, 3 May 2026
Line 16:		Line 16:

	<!--T:231-->		<!--T:231-->
	Minimally, a flake file contains a description of the flake, a set of input dependencies and an output. You can generate a very basic flake file ~~at any time~~ using <code>nix flake init</code>. This will populate the current directory with a file called flake.nix that will contain something akin to:		Minimally, a flake file contains a description of the flake, a set of input dependencies and an output. You can generate a very basic flake file after [[#Setup]] using <code>nix flake init</code>. This will populate the current directory with a file called flake.nix that will contain something akin to:
	</translate>		</translate>

Elec3137: fix: typo

2026-03-31T18:17:16Z

fix: typo

← Older revision		Revision as of 18:17, 31 March 2026
Line 429:		Line 429:

	<!--T:218-->		<!--T:218-->
	To allow for [[Unfree software\|unfree software]] in a flake project, you need to explicitly allow it by setting <code>config.~~allowUnree~~ = true;</code> when importing Nixpkgs.		To allow for [[Unfree software\|unfree software]] in a flake project, you need to explicitly allow it by setting <code>config.allowUnfree = true;</code> when importing Nixpkgs.
	</translate>		</translate>

Smudgebun at 07:47, 13 March 2026

2026-03-13T07:47:04Z

← Older revision		Revision as of 07:47, 13 March 2026
Line 16:		Line 16:

	<!--T:231-->		<!--T:231-->
	Minimally, a flake file contains a description of the flake, a set of input dependencies and an output. You can generate a very basic flake file at any time using nix flake init. This will populate the current directory with a file called flake.nix that will contain something akin to:		Minimally, a flake file contains a description of the flake, a set of input dependencies and an output. You can generate a very basic flake file at any time using <code>nix flake init</code>. This will populate the current directory with a file called flake.nix that will contain something akin to:
	</translate>		</translate>