diff --git a/docs/staff-docs/infrastructure/nix-hosts/vm.md b/docs/staff-docs/infrastructure/nix-hosts/vm.md
new file mode 100644
index 0000000..31a14de
--- /dev/null
+++ b/docs/staff-docs/infrastructure/nix-hosts/vm.md
@@ -0,0 +1,14 @@
+---
+title: Test configs in a VM
+---
+
+```
+nix build .\#colmenaHive.nodes.HOSTNAME.config.system.build.vm
+./result/bin/run-HOSTNAME-vm -vga virtio -display gtk,gl=on -smp CORES -m RAM
+# suggested: -smp 6 -m 12G
+```
+
+the login details for the vm will be:
+
+username: `test`
+password: `test`