nxbd switch-remote
¶
Deploy NixOS configurations to one or more remote systems. Supports configuration checks and automatic rebooting if needed.
This command assumes:
- Deployment target host address is defined by the hostname
and the (optional) FQDN and is obtained via
config.networking.fqdnOrHostName
. - The local user account that runs
nxbd
is used for connecting to the target host via SSH.
Arguments¶
systems
(optional)¶
System selection in flakes attribute syntax (e.g., .#hostname
or github:user/repo#hostname
). Can be one or many. Will select all systems in the flake in the current directory if not specified.
--ignore_checks
(optional)¶
Skip pre-deployment configuration checks
--reboot
(optional)¶
Automatically reboot if required by kernel/initrd changes