mirror of
https://github.com/nix-community/disko.git
synced 2024-11-04 05:44:29 +03:00
1b19111387
Reverts: 9abffdda13
3.2 KiB
3.2 KiB
How-to Guide: Disko
How to use Disko without NixOS
TODO: Still to be documented
Upgrading From Older disko versions
TODO: Include documentation here.
For now, see the upgrade guide
Installing NixOS module
You can use the NixOS module in one of the following ways:
Flakes (Current recommendation)
If you use nix flakes support:
{
inputs.disko.url = "github:nix-community/disko";
inputs.disko.inputs.nixpkgs.follows = "nixpkgs";
outputs = { self, nixpkgs, disko }: {
# change `yourhostname` to your actual hostname
nixosConfigurations.yourhostname = nixpkgs.lib.nixosSystem {
# change to your system:
system = "x86_64-linux";
modules = [
./configuration.nix
disko.nixosModules.disko
];
};
};
}
niv
First add it to niv:
niv add nix-community/disko
Then add the following to your configuration.nix in the imports
list:
{
imports = [ "${(import ./nix/sources.nix).disko}/modules/disko.nix" ];
}
nix-channel
As root run:
nix-channel --add https://github.com/nix-community/disko/archive/master.tar.gz disko
nix-channel --update
Then add the following to your configuration.nix in the imports
list:
{
imports = [ <disko/modules/disko.nix> ];
}
fetchTarball
Add the following to your configuration.nix:
{
imports = [ "${builtins.fetchTarball "https://github.com/nix-community/disko/archive/master.tar.gz"}/module.nix" ];
}
or with pinning:
{
imports = let
# replace this with an actual commit id or tag
commit = "f2783a8ef91624b375a3cf665c3af4ac60b7c278";
in [
"${builtins.fetchTarball {
url = "https://github.com/nix-community/disko/archive/${commit}.tar.gz";
# replace this with an actual hash
sha256 = "0000000000000000000000000000000000000000000000000000";
}}/module.nix"
];
}
Using the NixOS module
{
# checkout the example folder for how to configure different disko layouts
disko.devices = {
disk = {
vdb = {
device = "/dev/disk/by-id/some-disk-id";
type = "disk";
content = {
type = "gpt";
partitions = {
ESP = {
type = "EF00";
size = "100M";
content = {
type = "filesystem";
format = "vfat";
mountpoint = "/boot";
};
};
root = {
size = "100%";
content = {
type = "filesystem";
format = "ext4";
mountpoint = "/";
};
};
};
};
};
};
};
}
this will configure fileSystems
and other required NixOS options to boot the
specified configuration.
If you are on an installer, you probably want to disable enableConfig
.
disko will create the scripts disko-create
and disko-mount
which can be used
to create/mount the configured disk layout.