runNixOS :: AttrSet → Effect
Deploy a NixOS configuration to a machine.
You may want to use
This option allows you to insert a custom NixOS invocation, in case your configuration has already been invoked with the module system.
A NixOS configuration file or module.
configuration = ./configuration.nix;
Required, unless you invoke the module system yourself via xref:param-config.
Path of the Nixpkgs sources to use. These also include the NixOS sources.
pkgs is the Nixpkgs invocation that included the effects overlay.
Hostname to SSH to.
system of the machine to deploy.
system = "x86_64-linux";
system = "aarch64-linux";
Required, unless you pass the module system result via xref:param-config.
An effect that switches the NixOS system as configured.
The effect has the following attributes in addition to the attributes returned
config parameter of the module system. This can be used to inspect the
system configuration before committing it. For example:
nix repl ci.nix nix-repl> my-host.prebuilt.config.services.postgresql.enable false
A derivation representing the built system configuration.
Deploy a NixOS Machine — a step by step guide to deploy to an existing NixOS machine
runNixOps— provision interrelated machine configurations and other cloud resources
runArion— deploy services to Docker using NixOS, Nix or Docker-based images
runNixDarwin— the macOS equivalent for deploying to a single Apple machine configured with nix-darwin