Skip to content

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

--ignored_checks <ignored_checks> (optional)

Comma-separated list of checks to ignore in format group.check or group.* (e.g., 'remote_deployment.ssh_enabled,hardware_configuration.*')