nixpkgs/nixos/modules/system/boot/emergency-mode.nix
DavHau d5d323a907 emergencyMode, emergencyAccess: cross reference options in docs.
I was confused why I could not get an emergency access console despite setting systemd.emergencyMode=true.

Turns out there is another similar option `boot.initrd.systemd.emergencyAccess` that I should have used.

This is confusing and this change should make it more clear vie the docs of both these options.
2025-05-24 14:01:22 +07:00

41 lines
866 B
Nix

{
config,
lib,
options,
...
}:
{
###### interface
options = {
systemd.enableEmergencyMode = lib.mkOption {
default = true;
type = lib.types.bool;
description = ''
Whether to enable emergency mode, which is an
{command}`sulogin` shell started on the console if
mounting a filesystem fails. Since some machines (like EC2
instances) have no console of any kind, emergency mode doesn't
make sense, and it's better to continue with the boot insofar
as possible.
For initrd emergency access, use ${options.boot.initrd.systemd.emergencyAccess} instead.
'';
};
};
###### implementation
config = {
systemd.additionalUpstreamSystemUnits = lib.optionals config.systemd.enableEmergencyMode [
"emergency.target"
"emergency.service"
];
};
}