FuzzyBot: Updating to match new version of source page

2025-10-07T21:13:34Z

Updating to match new version of source page

← Older revision		Revision as of 21:13, 7 October 2025
Line 1:		Line 1:
	<languages/>		<languages/>
	[https://github.com/nix-community/disko Disko] is a utility and NixOS module for declarative disk partitioning.		<strong>[https://github.com/nix-community/disko Disko]</strong> is a utility and [[NixOS modules\|NixOS module]] for declarative disk partitioning.

	[https://github.com/nix-community/disko/blob/master/docs/INDEX.md Disko Documentation Index]		[https://github.com/nix-community/disko/blob/master/docs/INDEX.md Disko Documentation Index]

FuzzyBot: Updating to match new version of source page

2024-10-26T12:23:11Z

Updating to match new version of source page

← Older revision		Revision as of 12:23, 26 October 2024
Line 105:		Line 105:

	[[Category:Filesystem{{#translation:}}]]		[[Category:Filesystem{{#translation:}}]]
			[[Category:Deployment]]

FuzzyBot: Updating to match new version of source page

2024-07-20T12:37:14Z

Updating to match new version of source page

New page

<languages/>
[https://github.com/nix-community/disko Disko] is a utility and NixOS module for declarative disk partitioning.

[https://github.com/nix-community/disko/blob/master/docs/INDEX.md Disko Documentation Index]

== Usage ==

The following example creates a new GPT partition table for the disk <code>/dev/vda</code> including two partitions for EFI boot and a [[Special:MyLanguage/bcachefs|bcachefs]] root filesystem.

{{file|disko-config.nix|nix|<nowiki>
{
disko.devices = {
disk = {
main = {
device = "/dev/vda";
type = "disk";
content = {
type = "gpt";
partitions = {
ESP = {
end = "500M";
type = "EF00";
content = {
type = "filesystem";
format = "vfat";
mountpoint = "/boot";
};
};
root = {
name = "root";
end = "-0";
content = {
type = "filesystem";
format = "bcachefs";
mountpoint = "/";
};
};
};
};
};
};
};
}
</nowiki>}}

The following command will apply the disk layout specified in the configuration and mount them afterwards. Warning: This will erase all data on the disk.

{{Warning|The disko commands will erase all existing data on your disk and repartition it according to the given configuration.}}

<syntaxhighlight lang="console">
# sudo nix run github:nix-community/disko -- --mode disko ./disko-config.nix
</syntaxhighlight>

Alternativley use a disk layout configuration of a [https://github.com/Lassulus/flakes-testing remote repository] containing a <code>flake.nix</code> file as an entry point.

<syntaxhighlight lang="console">
# sudo nix run github:nix-community/disko -- --mode disko --flake github:Lassulus/flakes-testing#fnord
</syntaxhighlight>

The commands above requires [[Special:MyLanguage/Flake|Flake]] features available on your system.

To verify both partitions got mounted correctly, run

<syntaxhighlight lang="console">
# mount | grep /mnt
</syntaxhighlight>

== Configuration ==

In case the NixOS base system was installed on a partition layout bootstrapped with Disko, the disk config itself can be integrated into the system. First copy the file, for example <code>disko-config.nix</code> into your system configuration directory

<syntaxhighlight lang="console">
# cp disko-config.nix /etc/nixos/
</syntaxhighlight>

Add the Disko module on a flake-enabled system. Insert the required input and reference it and your <code>disko-config.nix</code> in the modules section. For alternative installation methods consult the Disko [https://github.com/nix-community/disko/blob/master/docs/quickstart.md quickstart guide].

{{file|/etc/nixos/flake.nix|nix|<nowiki>
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-23.05";
disko.url = "github:nix-community/disko";
disko.inputs.nixpkgs.follows = "nixpkgs";
};

outputs = {self, nixpkgs, disko, ...}@inputs: {

nixosConfigurations.mysystem = inputs.nixpkgs.lib.nixosSystem {
system = "x86_64-linux";
specialArgs.inputs = inputs;
modules = [
disko.nixosModules.disko
./disko-config.nix
{
disko.devices.main.device = nixpkgs.lib.mkForce "/dev/vda";
}
./configuration.nix
];
};
};
}
</nowiki>}}

Ensure that there are no automatically generated entries of <code>fileSystems</code> options in <code>/etc/nixos/hardware-configuration.nix</code>. Disko will automatically generate them for you. Rebuild your system to apply the Disko configuration.

[[Category:Filesystem{{#translation:}}]]

Disko/en - Revision history

FuzzyBot: Updating to match new version of source page

FuzzyBot: Updating to match new version of source page

FuzzyBot: Updating to match new version of source page