diff --git a/morph/grid/local/README.rst b/morph/grid/local/README.rst index 2246d40b79816f4f652557f2a3bb09bf02275058..63101e77db4fcc5b1bc359765f86e451db331e4a 100644 --- a/morph/grid/local/README.rst +++ b/morph/grid/local/README.rst @@ -8,20 +8,38 @@ Issues with networking that looked like guest misconfigurations vanished after c This requires `NixOS <https://nixos.org/>`_. Nix without the OS will not work. -Use the local development environment -````````````````````````````````````` -0. Add VirtualBox to your NixOs system configuration at ``/etc/nixos/configuration.nix``:: +Setup virtualisation on the host +```````````````````````````````` + +* VirtualBox + + 1. Add VirtualBox to your NixOs system configuration at ``/etc/nixos/configuration.nix``:: virtualisation.virtualbox.host.enable = true; # Save bytes and build time, optional but recommended: virtualisation.virtualbox.host.headless = true; - # Create a local pool for libvirt +* LibVirt + + 1. Add LibVirt to your NixOS system configuration at ``/etc/nixos/configuration.nix``:: + + virtualisation.libvirtd.enable = true; + security.polkit.enable = true; + # Enable HW acceleration if available + #boot.kernelModules = [ "kvm-amd" "kvm-intel" ]; + +2. Create a local pool for libvirt (optional):: + + export POOL_NAME=morph_local mkdir -p ~/.libvirt/images - sudo virsh pool-define-as morph_local --type dir --target ${HOME}/.libvirt/images - virsh pool-autostart morph_local - virsh pool-start morph_local + sudo virsh pool-define-as $POOL_NAME --type dir --target ${HOME}/.libvirt/images + sudo virsh pool-autostart $POOL_NAME + sudo virsh pool-start $POOL_NAME + + +Use the local development environment +````````````````````````````````````` 1. Enter the morph local grid directory::