Move installation guide to docs

This commit is contained in:
dump_stack() 2020-02-02 01:43:27 +00:00
parent cc5262b10f
commit 7cad1efce8
Signed by: dump_stack
GPG Key ID: BE44DA8C062D87DC
2 changed files with 43 additions and 18 deletions

View File

@ -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

42
docs/installation.rst Normal file
View File

@ -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