nixos-hardware/microsoft/hyper-v/README.md

64 lines
3.2 KiB
Markdown
Raw Permalink Normal View History

This is a setup for installing NixOS in Hyper-V as a guest.
I don't have details handy anymore on the detailed steps I had to do on the Windows host
(there's no NixWindows yet, unfortunately...), so you'll have to try googling that yourself, e.g. something like
"linux on hyper-v" or "ubuntu on hyper-v". (You're welcome to send PRs with improvements of this guide.)
Below, I'm providing only the info with what to do on the NixOS side of things.
## Installation ##
I basically followed the [guide for NixOS on VirtualBox](https://nixos.org/wiki/Installing_NixOS_in_a_VirtualBox_guest).
However, some additional changes in `/etc/nixos/configuration.nix` were required to really make it work
(I don't include them as a .nix file, as they must be done **before `nixos-install`**, and I'm not sure how to proceed
with cloning the nixos-hardware repo at this stage):
# REQUIRED - see: https://github.com/nixos/nixpkgs/issues/9899
boot.initrd.kernelModules = ["hv_vmbus" "hv_storvsc"];
# RECOMMENDED
# - use 800x600 resolution for text console, to make it easy to fit on screen
boot.kernelParams = ["video=hyperv_fb:800x600"]; # https://askubuntu.com/a/399960
# - avoid a problem with `nix-env -i` running out of memory
boot.kernel.sysctl."vm.overcommit_memory" = "1"; # https://github.com/NixOS/nix/issues/421
# UNKNOWN - not sure if below are needed; were suggested for VirtualBox and I used them
boot.loader.grub.device = "/dev/sda";
boot.initrd.checkJournalingFS = false;
## Shared folder ##
To share a folder between Windows host and Linux/NixOS guest, the typical solution seems to be to make a folder "shared"
on Windows, then access it via Samba from NixOS.
On the Windows host, I had to make an additional virtual switch in Hyper-V Manager, with mode "internal".
Then in properties of the virtual network card on Windows host (attached to the virtual switch), I
changed the IP to a fixed 10.0.0.100 (mask 255.255.255.240). I also added a special purpose user on the host, with some
long randomly generated password, to act as Samba credentials for NixOS.
To test that it works, I used the following commands:
$ nix-env -iA nixos.samba
$ smbclient -L //10.0.0.100 -U shares-guest%ReplaceWithSomeLongRandomlyGeneratedPassword
Domain=[DESKTOP-ABCD123] OS=[Windows 10 Pro 14393] Server=[Windows 10 Pro 6.3]
Sharename Type Comment
--------- ---- -------
ADMIN$ Disk Administracja zdalna
C$ Disk Domyślny udział
IPC$ IPC Zdalne wywołanie IPC
shared-space Disk
Connection to 10.0.0.100 failed (Error NT_STATUS_RESOURCE_NAME_NOT_FOUND)
NetBIOS over TCP disabled -- no workgroup available
$ nix-env -e samba
Then I added the following lines in `/etc/nixos/configuration.nix`:
# Client for shared folder on Windows Hyper-V host
# Based on: nixpkgs.git/nixos/tests/samba.nix
fileSystems."/vm-share" = {
fsType = "cifs";
device = "//10.0.0.100/shared-space";
options = [ "username=shares-guest" "password=ReplaceWithSomeLongRandomlyGeneratedPassword" ];
};
networking.interfaces.eth1.ip4 = [{address="10.0.0.101"; prefixLength=28;}];