2023-05-24 15:21:18 +03:00
|
|
|
# System Requirements: nixos-anywhere
|
|
|
|
|
|
|
|
**_Install NixOS everywhere via ssh_**
|
|
|
|
|
2023-11-22 22:15:27 +03:00
|
|
|
<img src="https://raw.githubusercontent.com/nix-community/nixos-anywhere/main/docs/logo.png" width="150" height="150">
|
2023-05-24 15:21:18 +03:00
|
|
|
|
2023-05-29 15:54:03 +03:00
|
|
|
[Documentation Index](./INDEX.md)
|
2023-05-24 16:24:14 +03:00
|
|
|
|
|
|
|
## Requirements
|
2023-05-24 15:21:18 +03:00
|
|
|
|
2023-09-17 16:28:17 +03:00
|
|
|
### Source Machine:
|
|
|
|
|
|
|
|
1. **Supported Systems:**
|
|
|
|
- Linux or macOS computers with Nix installed.
|
|
|
|
- NixOS
|
|
|
|
- Windows systems using WSL2.
|
|
|
|
|
2023-09-17 17:28:12 +03:00
|
|
|
_Note_: Should be able to build nix derivations for the target platform.
|
|
|
|
Otherwise `--build-on-remote` can be used.
|
|
|
|
|
2023-09-17 16:28:17 +03:00
|
|
|
2. **Nix Installation:** If Nix is not yet installed on your system, refer to
|
|
|
|
the [nix installation page](https://nixos.org/download#download-nix).
|
|
|
|
|
|
|
|
### Destination Machine:
|
|
|
|
|
2023-09-17 17:28:12 +03:00
|
|
|
The machine must be reachable over the public internet or local network.
|
|
|
|
Nixos-anywhere does not support wifi networks. If a VPN is needed, define a
|
|
|
|
custom installer via the --kexec flag which connects to your VPN.
|
|
|
|
|
2023-09-17 16:28:17 +03:00
|
|
|
1. **Direct Boot Option:**
|
|
|
|
- Must be already running a NixOS installer.
|
|
|
|
|
|
|
|
2. **Alternative Boot Options:** If not booting directly from a NixOS installer
|
|
|
|
image:
|
|
|
|
- **Architecture & Support:** Must be operating on:
|
|
|
|
- x86-64 or aarch64 Linux systems with kexec support. Note: While most
|
|
|
|
x86-64 Linux systems support kexec, if you're using an architecture other
|
|
|
|
than those mentioned, you may need to specify a
|
2023-09-17 17:10:10 +03:00
|
|
|
[different kexec image](./howtos/INDEX.md#using-your-own-kexec-image)
|
|
|
|
manually.
|
2023-09-17 16:28:17 +03:00
|
|
|
- **Memory Requirements:**
|
2024-06-07 16:17:08 +03:00
|
|
|
- At least 1 GB of RAM (excluding swap space).
|