Руководство по установке NixOS

Это руководство служит вспомогательным руководством для официального руководства. Оно описывает установку NixOS как полноценной операционной системы, смотрите Nix Installation Guide.

Помимо описания действий из официального руководства, здесь приводятся проверенные инструкции для типичных сценариев использования. В случае расхождения между руководством и данным документом приоритетным считается вариант, описанный в руководстве.

Цель установки

NixOS может быть установлена на различные типы устройств:

обычные (Intel или AMD) настольные компьютеры, ноутбуки или физически доступные сервера, представленные на этой странице
Мини-компьютеры (как Raspberry Pi's) или другие платы на архитектуре ARM, смотрите [[NixOS on ARM][
Облачные или удаленные сервера, смотрите NixOS friendly hosters

Методы установки

NixOS, как и многие другие Linux-базированные операционные системы, может быть установлен разными путями

Обычный способ, загрузка с загрузочного диска. (Написано ниже.)
Booting the media from an existing Linux installation

Создание загрузочного диска

С NixOS 14.11 установочный ISO образ гибридный. Это значит что он может загружаться как с CD так и с USB накопителя. Он может загружаться как с EFI систем, с более современных материнских плат и компьютеров Apple. Данная инструкция покажет стандартный способ копирования образа на USB накопитель. Если у вас CD или DVD накопитель, используйте способы для записи диска с ISO образа.

Запись образа на USB накопитель

Для начала, скачайте образ NixOS ISO image или create a custom ISO. Затем, вставьте USB накопитель, размер которого больше чем вес образа. Затем, следуйте инструкциям:

Для Linux

Найдите правильное устройство с lsblk or fdisk -l. Переместите /dev/sdX на нужное устройство по следующим шагам.
Скопируйте на устройство: cp nixos-xxx.iso /dev/sdX

Note: не используйте /dev/sdX1 или разделы на диске, используйте раздел: /dev/sdX.

Запишите образ на диск с помощью команды: dd if=nixos.iso of=/dev/sdX bs=4M status=progress conv=fdatasync

Для macOS

Найдите правильное устройство: diskutil list, затем напишите: diskX.
Размонтируйте: diskutil unmountDisk diskX.
Запишите: sudo dd if=path_to_nixos.iso of=/dev/diskX

Template:Подсказка

Для Windows

Download USBwriter.
Start USBwriter.
Choose the downloaded ISO as 'Source'
Choose the USB drive as 'Target'
Click 'Write'
When USBwriter has finished writing, safely unplug the USB drive.

Альтернативные способы установки

Способы приведенные выше являются одними из способов создания USB накопителя для загрузки

Эти методы написаны в гайде, но вы их можете использовать и для создания мультизагрузочной флешки. Этот способ не поддерживается, результат может получиться разным

Загрузка установочного накопителя

Template:Дополнение

Установочный накопитель гибридный и может загружаться как в legacy BIOS режиме так и в UEFI режиме

Вне зависимости от способа загрузки, на вашей материнской плате или компьютере возможно прийдется разрешить загрузку с CD/DVD диска или USB накопителя

Legacy bios boot

Это единственный возможный вариант загрузки на компьютерах без EFI/UEFI

UEFI boot

Загрузочный образ не подписан, поэтому EFI загрузчики могут ругаться. Для беспроблемной загрузки обязательно отключите Secure Boot в настройках

Подключение к интернету

Для установки обязательно нужен работающий интернет. Также, возможна установка без интернета, но нужен специальный образ

Проводной интернет

Для сетевых интерфейсов, поддерживаемых ядром, получение адреса по DHCP должно завершиться к моменту, когда станет доступна консоль.

По модему (раздача интернета)

Если вы не можете подключить интернет с помощью кабеля или WiFi, просто подключите свой смартфон по проводу, и включите в настройках режим "USB-модема". Если ваш телефон поддерживается драйверами ядра, то у вас появится интернет.

Беспроводное подключение

NetworkManager устанавливается в образе с графическим интерфейсом, также возможно использование nmtui в консоли для подключения к интернету

Используя вкладку "Приложения" в левом верхнем углу или панель запуска в нижней части экрана, выберите терминал и запустите в нем команду nmtui. Это позволит вам активировать (беспроводное) соединение: в списке должны отобразиться доступные сети (SSID); если нужной сети нет, можно добавить новое соединение. После активации и проверки беспроводного соединения программа установки, запущенная при старте системы, скорее всего, еще не обнаружит новое подключение. Закройте программу установки и запустите ее заново с панели в нижней части экрана — теперь она должна распознать новое соединение и продолжить работу.

On the minimal ISO, or if you are more familiar with wpa_supplicant then you can also run wpa_passphrase ESSID | sudo tee /etc/wpa_supplicant.conf, then enter your password and systemctl restart wpa_supplicant.

Partitioning

To partition the persistent storage run sudo fdisk /dev/diskX and follow instructions for MBR or (U)EFI. To determine which mode you are booted into, run:

$ [ -d /sys/firmware/efi/efivars ] && echo "UEFI" || echo "Legacy"

A very simple example setup is given here.

Legacy Boot (MBR)

o (dos disk label)
n new
p primary (4 primary in total)
1 (partition number [1/4])
2048 first sector (alignment for performance)
+500M last sector (boot sector size)
rm signature (Y), if ex. => warning of overwriting existing system, could use wipefs
n
p
2
default (fill up partition)
default (fill up partition)
w (write)

UEFI

g (gpt disk label)
n
1 (partition number [1/128])
2048 first sector
+500M last sector (boot sector size)
t
1 (EFI System)
n
2
default (fill up partition)
default (fill up partition)
w (write)

Format partitions

The example below uses the ext4 filesystem format. If you wish to use other filesystem formats such as Btrfs or ZFS:

This is useful for having multiple setups and makes partitions easier to handle

$ lsblk # lists current system block devices
# mkfs.fat -F 32 -n boot /dev/sdX1
# mkfs.ext4 /dev/sdX2 -L nixos
# mount /dev/disk/by-label/nixos /mnt
# mkdir -p /mnt/boot
# mount /dev/disk/by-label/boot /mnt/boot

NixOS configuration

NixOS is configured through a declarative configuration file. To generate a default config file, run nixos-generate-config:

# nixos-generate-config --root /mnt
# nano /mnt/etc/nixos/configuration.nix

For information on working with a system configuration, see NixOS system configuration. For desktop-specific configurations, see NixOS as a desktop.

Most essential changes:

keyboard layout, ie services.xserver.xkb.layout
networking (wifi), see below for fix if it breaks
install editor to edit the configuration

The self-documenting NixOS options can be searched with NixOS options search.

Swap file

For additional methods of configuring swap, see Swap. The following example demonstrates how to create and enable a swap file:

❄︎ /mnt/etc/nixos/configuration.nix

  swapDevices = [{
    device = "/var/lib/swapfile";
    size = 16*1024; # 16 GB
  }];

Bootloader

NixOS supports multiple bootloaders such as GNU GRUB and Systemd/boot.

Systemd-boot is the recommended bootloader. The following example demonstrates how to enable systemd-boot in your configuration:

❄︎ /mnt/etc/nixos/configuration.nix

  boot.loader.systemd-boot.enable = true;

You may also wish to configure Secure Boot.

Users

For information on creating and managing users, see User management and the NixOS Manual: Chapter - Package Management. See an example below:

❄︎ /mnt/etc/nixos/configuration.nix

  users.users.alice = {
    isNormalUser = true;
    initialPassword = "pw123";
  };

NixOS installation

# cd /mnt
# nixos-install

after installation: Run passwd to change user password.

if internet broke/breaks, try one of the following:

# nixos-rebuild switch --option substitute false # no downloads
# nixos-rebuild switch --option binary-caches "" # no downloads

wpa_supplicant flags to connect to wifi

Additional notes for specific hardware

These are collected notes or links for specific hardware issues.

Blog post how to install NixOS on a Dell 9560
Brand servers may require extra kernel modules be included into initrd (boot.initrd.extraKernelModules in configuration.nix) For example HP Proliant needs "hpsa" module to see the disk drive.