NixOS Installation Guide - Revision history

EnterJazz: Using wpa_supplicant.conf on the mininmal OS installer wasn't working for me. I found using `nmcli` to be a lot easier to get wifi working, hence I added it here.

2026-03-22T08:56:47Z

Using wpa_supplicant.conf on the mininmal OS installer wasn't working for me. I found using `nmcli` to be a lot easier to get wifi working, hence I added it here.

← Older revision		Revision as of 08:56, 22 March 2026
Line 127:		Line 127:
	<!--T:43-->		<!--T:43-->
	On the minimal ISO, or if you are more familiar with [[wpa_supplicant]] then you can also run <code>wpa_passphrase ESSID \| sudo tee /etc/wpa_supplicant.conf</code>, then enter your password and <code>systemctl restart wpa_supplicant</code>.		On the minimal ISO, or if you are more familiar with [[wpa_supplicant]] then you can also run <code>wpa_passphrase ESSID \| sudo tee /etc/wpa_supplicant.conf</code>, then enter your password and <code>systemctl restart wpa_supplicant</code>.

			The minimal OS wifi may also be set up using <code>nmcli</code>: <code>nmcli device wifi connect ESSID password PASSWORD</code>

	== Partitioning == <!--T:44-->		== Partitioning == <!--T:44-->

Ardenet: Marked this version for translation

2025-10-08T06:23:13Z

Marked this version for translation

← Older revision		Revision as of 06:23, 8 October 2025
Line 139:		Line 139:

	<translate>		<translate>
			<!--T:63-->
	A very simple example setup is given here.		A very simple example setup is given here.

Line 176:		Line 177:
	=== Format partitions === <!--T:50-->		=== Format partitions === <!--T:50-->

			<!--T:64-->
	The example below uses the [[ext4]] filesystem format. If you wish to use other filesystem formats such as [[Btrfs]] or [[ZFS]]:		The example below uses the [[ext4]] filesystem format. If you wish to use other filesystem formats such as [[Btrfs]] or [[ZFS]]:

			<!--T:65-->
	* [[Bcachefs#NixOS installation on bcachefs]]		* [[Bcachefs#NixOS installation on bcachefs]]
	* [[Btrfs#Installation of NixOS on btrfs]]		* [[Btrfs#Installation of NixOS on btrfs]]
Line 199:		Line 202:
	== NixOS configuration == <!--T:53-->		== NixOS configuration == <!--T:53-->

			<!--T:66-->
	NixOS is configured through a [[Overview of the NixOS Linux distribution#Declarative Configuration\|declarative configuration]] file. To generate a default config file, run [[nixos-generate-config]]:		NixOS is configured through a [[Overview of the NixOS Linux distribution#Declarative Configuration\|declarative configuration]] file. To generate a default config file, run [[nixos-generate-config]]:
	</translate>		</translate>
Line 208:		Line 212:

	<translate>		<translate>
			<!--T:67-->
	For information on working with a system configuration, see [[NixOS system configuration]]. For desktop-specific configurations, see [[NixOS as a desktop]].		For information on working with a system configuration, see [[NixOS system configuration]]. For desktop-specific configurations, see [[NixOS as a desktop]].

			<!--T:68-->
	Most essential changes:		Most essential changes:

Line 222:		Line 228:
	=== Swap file === <!--T:52-->		=== Swap file === <!--T:52-->

			<!--T:69-->
	For additional methods of configuring swap, see [[Swap]]. The following example demonstrates how to create and enable a [[Swap#Swap file\|swap file]]:		For additional methods of configuring swap, see [[Swap]]. The following example demonstrates how to create and enable a [[Swap#Swap file\|swap file]]:
	</translate>		</translate>
Line 235:		Line 242:

	<translate>		<translate>
	=== Bootloader ===		=== Bootloader === <!--T:70-->

			<!--T:71-->
	NixOS supports multiple [[Bootloader\|bootloaders]] such as [[GNU GRUB]] and [[Systemd/boot]].		NixOS supports multiple [[Bootloader\|bootloaders]] such as [[GNU GRUB]] and [[Systemd/boot]].

			<!--T:72-->
	Systemd-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:		Systemd-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:
	</translate>		</translate>
Line 249:		Line 258:

	<translate>		<translate>
			<!--T:73-->
	You may also wish to configure [[Secure Boot]].		You may also wish to configure [[Secure Boot]].

	=== Users ===		=== Users === <!--T:74-->

			<!--T:75-->
	For information on creating and managing users, see [[User management]] and the {{NixOS Manual\|name=NixOS Manual: Chapter - Package Management\|anchor=#sec-user-management}}. See an example below:		For information on creating and managing users, see [[User management]] and the {{NixOS Manual\|name=NixOS Manual: Chapter - Package Management\|anchor=#sec-user-management}}. See an example below:
	</translate>		</translate>
Line 275:		Line 286:

	<translate>		<translate>
			<!--T:76-->
	after installation: Run <code>passwd</code> to change user password.		after installation: Run <code>passwd</code> to change user password.

Ardenet: adjust translate tag's placement

2025-10-08T06:20:54Z

adjust translate tag's placement

← Older revision		Revision as of 06:20, 8 October 2025
Line 132:		Line 132:
	<!--T:45-->		<!--T:45-->
	To partition the persistent storage run <code>sudo fdisk /dev/diskX</code> and follow instructions for MBR or (U)EFI. To determine which mode you are booted into, run:		To partition the persistent storage run <code>sudo fdisk /dev/diskX</code> and follow instructions for MBR or (U)EFI. To determine which mode you are booted into, run:
			</translate>

	<syntaxhighlight lang="console">		<syntaxhighlight lang="console">
Line 137:		Line 138:
	</syntaxhighlight>		</syntaxhighlight>

			<translate>
	A very simple example setup is given here.		A very simple example setup is given here.

Line 175:		Line 176:
	=== Format partitions === <!--T:50-->		=== Format partitions === <!--T:50-->

	~~<!--T:51-->~~
	The example below uses the [[ext4]] filesystem format. If you wish to use other filesystem formats such as [[Btrfs]] or [[ZFS]]:		The example below uses the [[ext4]] filesystem format. If you wish to use other filesystem formats such as [[Btrfs]] or [[ZFS]]:

Line 183:		Line 183:
	* [[ZFS#Simple NixOS ZFS on root installation]]		* [[ZFS#Simple NixOS ZFS on root installation]]

	This is useful for having multiple setups and makes partitions easier to handle<syntaxhighlight lang="console">		<!--T:51-->
			This is useful for having multiple setups and makes partitions easier to handle
			</translate>

			<syntaxhighlight lang="console">
	$ lsblk # lists current system block devices		$ lsblk # lists current system block devices
	# mkfs.fat -F 32 -n boot /dev/sdX1		# mkfs.fat -F 32 -n boot /dev/sdX1
Line 192:		Line 196:
	</syntaxhighlight>		</syntaxhighlight>

	<!--T:53-->		<translate>
	~~== NixOS configuration ==~~		== NixOS configuration == <!--T:53-->

	NixOS is configured through a [[Overview of the NixOS Linux distribution#Declarative Configuration\|declarative configuration]] file. To generate a default config file, run [[nixos-generate-config]]:		NixOS is configured through a [[Overview of the NixOS Linux distribution#Declarative Configuration\|declarative configuration]] file. To generate a default config file, run [[nixos-generate-config]]:
			</translate>

	<syntaxhighlight lang="console">		<syntaxhighlight lang="console">
Line 202:		Line 207:
	</syntaxhighlight>		</syntaxhighlight>

			<translate>
	For information on working with a system configuration, see [[NixOS system configuration]]. For desktop-specific configurations, see [[NixOS as a desktop]].		For information on working with a system configuration, see [[NixOS system configuration]]. For desktop-specific configurations, see [[NixOS as a desktop]].

Line 214:		Line 220:
	The self-documenting NixOS options can be searched with [https://search.nixos.org/options NixOS options search].		The self-documenting NixOS options can be searched with [https://search.nixos.org/options NixOS options search].

	<!--T:52-->		=== Swap file === <!--T:52-->
	~~=== Swap file ===~~

	For additional methods of configuring swap, see [[Swap]]. The following example demonstrates how to create and enable a [[Swap#Swap file\|swap file]]:		For additional methods of configuring swap, see [[Swap]]. The following example demonstrates how to create and enable a [[Swap#Swap file\|swap file]]:
			</translate>

	{{file\|/mnt/etc/nixos/configuration.nix\|nix\|		{{file\|/mnt/etc/nixos/configuration.nix\|nix\|
Line 228:		Line 234:
	}}		}}

			<translate>
	=== Bootloader ===		=== Bootloader ===

Line 233:		Line 240:

	Systemd-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:		Systemd-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:
			</translate>

	{{file\|/mnt/etc/nixos/configuration.nix\|nix\|		{{file\|/mnt/etc/nixos/configuration.nix\|nix\|
Line 240:		Line 248:
	}}		}}

			<translate>
	You may also wish to configure [[Secure Boot]].		You may also wish to configure [[Secure Boot]].

Line 245:		Line 254:

	For information on creating and managing users, see [[User management]] and the {{NixOS Manual\|name=NixOS Manual: Chapter - Package Management\|anchor=#sec-user-management}}. See an example below:		For information on creating and managing users, see [[User management]] and the {{NixOS Manual\|name=NixOS Manual: Chapter - Package Management\|anchor=#sec-user-management}}. See an example below:
			</translate>

	{{file\|/mnt/etc/nixos/configuration.nix\|nix\|		{{file\|/mnt/etc/nixos/configuration.nix\|nix\|
Line 255:		Line 265:
	}}		}}

	== NixOS installation ==		<translate>
			== NixOS installation == <!--T:56-->
			</translate>

	<syntaxhighlight lang="console">		<syntaxhighlight lang="console">
	# cd /mnt		# cd /mnt
	# nixos-install		# nixos-install
	</syntaxhighlight>after installation: Run <code>passwd</code> to change user password.		</syntaxhighlight>

			<translate>
			after installation: Run <code>passwd</code> to change user password.

	<!--T:57-->		<!--T:57-->
	if internet broke/breaks, try one of the following:<syntaxhighlight lang="console">		if internet broke/breaks, try one of the following:
			</translate>

			<syntaxhighlight lang="console">
	# nixos-rebuild switch --option substitute false # no downloads		# nixos-rebuild switch --option substitute false # no downloads
	# nixos-rebuild switch --option binary-caches "" # no downloads		# nixos-rebuild switch --option binary-caches "" # no downloads
	</syntaxhighlight>		</syntaxhighlight>

			<translate>
			<!--T:58-->
	* wpa_supplicant flags to connect to wifi		* wpa_supplicant flags to connect to wifi
			</translate>

	~~<!--T:58-->~~
	<hr />		<hr />

			<translate>
	== Additional notes for specific hardware == <!--T:59-->		== Additional notes for specific hardware == <!--T:59-->

Pigeon: fix typo in #Custom_configuration

2025-08-20T16:50:14Z

fix typo in #Custom_configuration

← Older revision		Revision as of 16:50, 20 August 2025
Line 232:		Line 232:
	NixOS supports multiple [[Bootloader\|bootloaders]] such as [[GNU GRUB]] and [[Systemd/boot]].		NixOS supports multiple [[Bootloader\|bootloaders]] such as [[GNU GRUB]] and [[Systemd/boot]].

	~~Sysyemd~~-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:		Systemd-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:

	{{file\|/mnt/etc/nixos/configuration.nix\|nix\|		{{file\|/mnt/etc/nixos/configuration.nix\|nix\|

Neic: fix bug in partition label

2025-06-15T13:32:43Z

fix bug in partition label

← Older revision		Revision as of 13:32, 15 June 2025
Line 187:		Line 187:
	# mkfs.fat -F 32 -n boot /dev/sdX1		# mkfs.fat -F 32 -n boot /dev/sdX1
	# mkfs.ext4 /dev/sdX2 -L nixos		# mkfs.ext4 /dev/sdX2 -L nixos
	# mount /dev/disk/by-label/~~root~~ /mnt		# mount /dev/disk/by-label/nixos /mnt
	# mkdir -p /mnt/boot		# mkdir -p /mnt/boot
	# mount /dev/disk/by-label/boot /mnt/boot		# mount /dev/disk/by-label/boot /mnt/boot

Pigs: /* NixOS configuration */ add links to other pages

2025-06-09T05:10:52Z

NixOS configuration: add links to other pages

← Older revision		Revision as of 05:10, 9 June 2025
Line 201:		Line 201:
	# nano /mnt/etc/nixos/configuration.nix		# nano /mnt/etc/nixos/configuration.nix
	</syntaxhighlight>		</syntaxhighlight>

			For information on working with a system configuration, see [[NixOS system configuration]]. For desktop-specific configurations, see [[NixOS as a desktop]].

	Most essential changes:		Most essential changes:
Line 253:		Line 255:
	}}		}}

	~~<!--T:56-->~~
	== NixOS installation ==		== NixOS installation ==
	<syntaxhighlight lang="console">		<syntaxhighlight lang="console">

Bzadm: fix typo

2025-06-03T00:35:20Z

fix typo

← Older revision		Revision as of 00:35, 3 June 2025
Line 187:		Line 187:
	# mkfs.fat -F 32 -n boot /dev/sdX1		# mkfs.fat -F 32 -n boot /dev/sdX1
	# mkfs.ext4 /dev/sdX2 -L nixos		# mkfs.ext4 /dev/sdX2 -L nixos
	# mount /dev/disk/by-label/~~boot~~ /mnt		# mount /dev/disk/by-label/root /mnt
	# mkdir -p /mnt/boot		# mkdir -p /mnt/boot
	# mount /dev/disk/by-label/boot /mnt/boot		# mount /dev/disk/by-label/boot /mnt/boot

Pigs: extra configuration examples, link to more pages, clean up wording

2025-05-28T05:27:15Z

extra configuration examples, link to more pages, clean up wording

Show changes

Mayer at 13:44, 23 February 2025

2025-02-23T13:44:29Z

← Older revision		Revision as of 13:44, 23 February 2025
Line 1:		Line 1:
			<languages/>
	<translate>		<translate>
	<!--T:1-->		<!--T:1-->

Sk7Str1p3: Marked this version for translation

2025-01-11T17:01:22Z

Marked this version for translation

Show changes