From 7cad1efce84f7114f2cd778cdad14c760182c6e0 Mon Sep 17 00:00:00 2001
From: Mikhail Klementev <blame@dumpstack.io>
Date: Sun, 2 Feb 2020 01:43:27 +0000
Subject: [PATCH] Move installation guide to docs

---
 README.md             | 19 +------------------
 docs/installation.rst | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+), 18 deletions(-)
 create mode 100644 docs/installation.rst

diff --git a/README.md b/README.md
index 2ec252b..063756e 100644
--- a/README.md
+++ b/README.md
@@ -12,24 +12,7 @@ Uses one **read-only** /nix directory for all appvms. So creating a new appvm (b
 
 ## Installation
 
-### Requirements
-
-    $ sudo apt install virt-manager curl git
-    $ sudo usermod -a -G libvirt $USER # group can also be "libvirtd"
-    $ newgrp libvirt
-    $ echo user = "\"$USER\"" | sudo tee -a /etc/libvirt/qemu.conf
-    $ sudo systemctl restart libvirtd
-
-### Install Nix package manager
-
-    $ sudo mkdir -m 0755 /nix && sudo chown $USER /nix
-    $ curl https://nixos.org/nix/install | sh
-    $ nix-channel --add https://nixos.org/channels/nixos-19.09 nixpkgs
-    $ . ~/.nix-profile/etc/profile.d/nix.sh
-
-### Install appvm
-
-    $ nix-env -if https://code.dumpstack.io/tools/appvm/archive/master.tar.gz
+See [related documentation](https://appvm.readthedocs.io/en/latest/installation.html).
 
 ## Usage
 
diff --git a/docs/installation.rst b/docs/installation.rst
new file mode 100644
index 0000000..42b60f9
--- /dev/null
+++ b/docs/installation.rst
@@ -0,0 +1,42 @@
+Installation
+============
+
+NixOS
+-----
+
+/etc/nixos/configuration.nix::
+
+  virtualisation.libvirtd = {
+    enable = true;
+    qemuVerbatimConfig = ''
+      namespaces = []
+      user = "${username}"
+      group = "users"
+    '';
+  };
+
+  users.users."${username}".extraGroups = [ ... "libvirtd" ];
+
+shell::
+
+  nix run -f https://code.dumpstack.io/tools/appvm/archive/master.tar.gz -c appvm
+
+Ubuntu 19.10
+------
+
+Requirements::
+
+  sudo apt install virt-manager curl git
+  echo user = "\"$USER\"" | sudo tee -a /etc/libvirt/qemu.conf
+  echo '/var/tmp/** rwlk,' | sudo tee -a /etc/apparmor.d/local/abstractions/libvirt-qemu
+  curl https://nixos.org/nix/install | sh
+  systemctl reboot
+
+Use latest stable nixpkgs channel::
+
+  nix-channel --add https://nixos.org/channels/nixos-19.09 nixpkgs
+  nix-channel --update
+
+Install appvm::
+
+  nix-env -if https://code.dumpstack.io/tools/appvm/archive/master.tar.gz