Add support for NixOS + Fedora, Arch, RH minor changes (#195)

* Add support for NixOS Signed-off-by: Maurice Zhou <jasper@apvc.uk> * updated files for immutable root fs Signed-off-by: Maurice Zhou <jasper@apvc.uk> * update ssh key location Signed-off-by: Maurice Zhou <jasper@apvc.uk> * change initrd host key name Signed-off-by: Maurice Zhou <jasper@apvc.uk> * add missing -p switch Signed-off-by: Maurice Zhou <jasper@apvc.uk> * comments about SSH and encrypted bpool Signed-off-by: Maurice Zhou <jasper@apvc.uk> * backup hardware-configuration.nix file Signed-off-by: Maurice Zhou <jasper@apvc.uk> * clearer wording for backup Signed-off-by: Maurice Zhou <jasper@apvc.uk> * global useDHCP flag is deprecated Signed-off-by: Maurice Zhou <jasper@apvc.uk> * point user to configuration.nix Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fixes for systemd-autofs; network; typo Signed-off-by: Maurice Zhou <jasper@apvc.uk> * force command to return 0 Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix command to postMount Signed-off-by: Maurice Zhou <jasper@apvc.uk> * fix mount command Signed-off-by: Maurice Zhou <jasper@apvc.uk> * escape $i Signed-off-by: Maurice Zhou <jasper@apvc.uk> * create mountpoints before booting Signed-off-by: Maurice Zhou <jasper@apvc.uk> * replace postDevice,preMount command Signed-off-by: Maurice Zhou <jasper@apvc.uk> * disable zfs-mount Signed-off-by: Maurice Zhou <jasper@apvc.uk> * generate machine-id Signed-off-by: Maurice Zhou <jasper@apvc.uk>
2021-09-06 17:48:50 +00:00
parent f40d19a2c5
commit a1f68c37e0
22 changed files with 1367 additions and 62 deletions
--- a/Started/NixOS/index.rst
+++ b/Started/NixOS/index.rst
@@ -0,0 +1,64 @@
+.. highlight:: sh
+
+NixOS
+=====
+
+Contents
+--------
+.. toctree::
+  :maxdepth: 1
+  :glob:
+
+  *
+
+Support
+-------
+Reach out to the community using the :ref:`mailing_lists` or IRC at
+`#zfsonlinux <ircs://irc.libera.chat/#zfsonlinux>`__ on `Libera Chat
+<https://libera.chat/>`__.
+
+If you have a bug report or feature request
+related to this HOWTO, please `file a new issue and mention @ne9z
+<https://github.com/openzfs/openzfs-docs/issues/new?body=@ne9z,%20I%20have%20the%20following%20issue%20with%20the%20Nix%20ZFS%20HOWTO:>`__.
+
+Installation
+------------
+
+Note: this is for installing ZFS on an existing
+NixOS installation. To use ZFS as root file system,
+see below.
+
+Live image ships with ZFS support by default.
+
+#. Import separate configration file for ZFS options::
+
+    vim /etc/nixos/configuration.nix
+    ##add './zfs.nix' to 'imports'
+    # imports = [ ./zfs.nix ];
+
+#. Configure ZFS options::
+
+    tee -a /etc/nixos/zfs.nix <<EOF
+    { config, pkgs, ... }:
+
+    { boot.supportedFilesystems = [ "zfs" ];
+      networking.hostId = "$(head -c 8 /etc/machine-id)";
+    }
+    EOF
+
+#. Apply configuation changes::
+
+    nixos-rebuild switch
+
+Root on ZFS
+-----------
+ZFS can be used as root file system for NixOS.
+An installation guide is available.
+
+`Start here <Root%20on%20ZFS/0-overview.html>`__.
+
+.. toctree::
+  :maxdepth: 1
+  :glob:
+
+  Root on ZFS/*