Disko: Difference between revisions
m Category:Deployment added |
m Minor formatting, in-link. |
||
Line 2: | Line 2: | ||
<translate> | <translate> | ||
<!--T:1--> | <!--T:1--> | ||
[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. | ||
<!--T:2--> | <!--T:2--> |
Latest revision as of 20:31, 30 October 2024
Disko is a utility and NixOS module for declarative disk partitioning.
Usage
The following example creates a new GPT partition table for the disk /dev/vda
including two partitions for EFI boot and a bcachefs root filesystem.
disko-config.nix
{
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 = "/";
};
};
};
};
};
};
};
}
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.
# sudo nix run github:nix-community/disko -- --mode disko ./disko-config.nix
Alternativley use a disk layout configuration of a remote repository containing a flake.nix
file as an entry point.
# sudo nix run github:nix-community/disko -- --mode disko --flake github:Lassulus/flakes-testing#fnord
The commands above requires Flake features available on your system.
To verify both partitions got mounted correctly, run
# mount | grep /mnt
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 disko-config.nix
into your system configuration directory
# cp disko-config.nix /etc/nixos/
Add the Disko module on a flake-enabled system. Insert the required input and reference it and your disko-config.nix
in the modules section. For alternative installation methods consult the Disko quickstart guide.
/etc/nixos/flake.nix
{
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
];
};
};
}
Ensure that there are no automatically generated entries of fileSystems
options in /etc/nixos/hardware-configuration.nix
. Disko will automatically generate them for you. Rebuild your system to apply the Disko configuration.