nix-community/nixos-anywhere
1
1
Fork 0
mirror of https://github.com/nix-community/nixos-anywhere.git synced 2024-07-14 19:40:42 +03:00
Code Issues Packages Projects Releases Wiki Activity
install nixos everywhere via ssh
19 Commits 18 Branches 6 Tags 3.1 MiB
Shell 46.6%
Nix 29.4%
HCL 24%
8b74013f19
Go to file
Jörg Thalheim 8b74013f19 gitignore results
2022-12-09 15:03:56 +01:00
.gitignore gitignore results 2022-12-09 15:03:56 +01:00
flake.lock add flake for nixos-remote 2022-12-09 14:56:06 +01:00
flake.nix also include aarch64-darwin 2022-12-09 14:58:07 +01:00
nixos-remote start installation with ssh-copy-id, allow custom kexec tarball 2022-11-24 17:29:15 +00:00
package.nix package: include dependencies in wrapper 2022-12-09 15:03:50 +01:00
README.md README: extend 2022-11-22 21:46:43 +01:00

README.md

nixos-remote - install nixos everywhere via ssh

nixos-remote makes it possible to install nixos from Linux machines reachable via ssh. Under the hood uses a kexec image to boot into a NixOS installer from a running Linux system. It then uses disko to partition and format the disks on the target system before it installs the user provided nixos configuration.

Requirements

  • x86_64 Linux system with kexec support (most x86_64 machine do have kexec support)
  • At least 2.5GB RAM (swap does not count). If you do not have enough RAM you will see failures unpacking the initrd), this is because kexec needs to load the whole nixos into memory.
  • DHCP: Currently nixos-remote requires that the network of the machine, offers DHCP for dynamic address configuration or else the booted nixos will not have any network set up.

Usage

Needs a repo with your configurations with flakes. For a minimal example checkout https://github.com/Lassulus/flakes-testing.

Your NixOS configuration will also need a disko configuration as we can see in our example

Afterwards you can just run:

./nixos-remote root@yourip --flake github:your-user/your-repo#your-system

The parameter passed to --flake should point to your nixos configuration exposed in your flake (nixosConfigurations.your-system in the example above).