NixOS Installation Guide: Difference between revisions

Line 1:

This guide ~~describes various ways of installing NixOS. The~~ [https://nixos.org/nixos/manual/index.html#ch-installation official manual] ~~should cover most usual~~ use-cases.

This guide is a companion guide for the [https://nixos.org/nixos/manual/index.html#ch-installation official manual]. In addition to describing the steps from the official manual, it provides known good instructions for common use cases. When there is a discrepancy between the manual and this guide, the supported case is the one described in the manual.

== Installing from ~~USB~~ ==

Use this guide as a step-by-step guide, choices will be presented, use only the selected section, and continue at the section it tells you to at the end.

== Installation target ==

NixOS can be installed on an increasing variety of hardware, including the usual x86-type hardware.

# A regular (Intel or AMD) desktop computer, laptop, or physically accessible server can follow the instructions in this page

# [[NixOS on ARM|SBCs, like the Raspberry Pis, and other ARM boards can follow the instructions at ''NixOS on ARM'']]

# [[NixOS friendly hosters|Cloud and remote servers will find various instructions at ''NixOS friendly hosters'']]

== Installation method ==

NixOS, as with most Linux-based operating systems, can be installed in different ways.

# [[#Installing from the installation media|The classic way, booting from the installation media (described in this page)]]

# [[Installing from Linux|Booting the media from an existing Linux installation]]

{{outdated|Starting from here, the installation guide haven't been revised yet.}}

=== Installing from the installation media ===

Since NixOS 14.11 the installer ISO is hybrid. This means it is bootable on both CD and USB drives. It also boots on EFI systems, like most modern motherboards and Mac* systems. Please read the [[#Hybrid image]] section on how to burn the ISO.

Line 181:

Line 201:

→ See [[NixOS friendly hosters]]

~~== Installing from Linux ==~~

~~→ See [[Installing from Linux]]~~

== Special hardware ==

@@ Line 1: / Line 1: @@
-This guide describes various ways of installing NixOS. The [https://nixos.org/nixos/manual/index.html#ch-installation official manual] should cover most usual use-cases.
+This guide is a companion guide for the [https://nixos.org/nixos/manual/index.html#ch-installation official manual]. In addition to describing the steps from the official manual, it provides known good instructions for common use cases. When there is a discrepancy between the manual and this guide, the supported case is the one described in the manual.
-== Installing from USB ==
+Use this guide as a step-by-step guide, choices will be presented, use only the selected section, and continue at the section it tells you to at the end.
+== Installation target ==
+NixOS can be installed on an increasing variety of hardware, including the usual x86-type hardware.
+# A regular (Intel or AMD) desktop computer, laptop, or physically accessible server can follow the instructions in this page
+# [[NixOS on ARM|SBCs, like the Raspberry Pis, and other ARM boards can follow the instructions at ''NixOS on ARM'']]
+# [[NixOS friendly hosters|Cloud and remote servers will find various instructions at ''NixOS friendly hosters'']]
+== Installation method ==
+NixOS, as with most Linux-based operating systems, can be installed in different ways.
+# [[#Installing from the installation media|The classic way, booting from the installation media (described in this page)]]
+# [[Installing from Linux|Booting the media from an existing Linux installation]]
+{{outdated|Starting from here, the installation guide haven't been revised yet.}}
+=== Installing from the installation media ===
 Since NixOS 14.11 the installer ISO is hybrid. This means it is bootable on both CD and USB drives. It also boots on EFI systems, like most modern motherboards and Mac* systems. Please read the [[#Hybrid image]] section on how to burn the ISO.
@@ Line 181: / Line 201: @@
 → See [[NixOS friendly hosters]]
-== Installing from Linux ==
-→ See [[Installing from Linux]]
 == Special hardware ==