docs: add README

README.md

@@ -0,0 +1,42 @@
+# Debian vm auto setup
+
+Install a debian headless virtual-machine from scratch with netboot in a QEMU environment
+
+## requirements
+
+- QEMU + KVM
+- tmux
+- bash
+- python3 (for http server)
+- telnet or netcat (to transmit logs)
+
+## Getting started
+
+```
+./setup_workspace.sh
+cd machines/machine01.local/
+./install_machine.sh
+```
+
+then on a client, connect to ssh via the port forwarding (in user mode network)
+```
+ssh -o StrictHostKeyChecking=no -p 42022 root@localhost
+```
+
+## troubleshooting
+
+kill qemu: pkill -f qemu-system-x86_64
+
+## TODO
+
+- find a better way to kill qemu
+
+## preseed file
+
+Change this line to add initial packages.
+
+`d-i pkgsel/include string binfmt-support debian-keyring openssh-server qemu-user-static`
+
+## inspiration
+
+https://sigmaris.info/blog/2019/04/automating-debian-install-qemu/

run_usernet.sh

@@ -1,11 +1,9 @@
 #!/usr/bin/bash
 qemu-system-x86_64 \
     -accel kvm \
-	-hda ./snapshot_02_working.img.qcow \
+	-hda ./main.qcow \
 	-cpu host \
 	-m 2048 \
 	-nographic \
     -net user,hostfwd=tcp::42022-:22,hostfwd=tcp::42080-:80,hostfwd=tcp::42043-:443 \
     -net nic
-
-# foobaristhebestpassword

setup_workspace.sh

@@ -4,11 +4,13 @@
 
 mkdir -p machines/machine01.local
 
+ln -f -s $(pwd)/files_to_serve/ ./machines/machine01.local/files_to_serve
+
 mkdir machines/machine01.local/tftp_container
 
 wget \
     -O ./machines/machine01.local/tftp_container/netboot.tar.gz \
-    https://ftp.debian.org/debian/dists/bookworm/main/installer-amd64/20230607/images/netboot/netboot.tar.gz
+    https://deb.debian.org/debian/dists/bookworm/main/installer-amd64/20230607/images/netboot/netboot.tar.gz
 
 tar -xzvf ./machines/machine01.local/tftp_container/netboot.tar.gz -C ./machines/machine01.local/tftp_container/
 
@@ -17,4 +19,6 @@ qemu-img create -f qcow2 ./machines/machine01.local/main.qcow 5G
 
 cp ./install_machine.sh ./machines/machine01.local/
 
+cp ./run_usernet.sh ./machines/machine01.local/run.sh
+
 cp ./debian_install_config_default ./machines/machine01.local/tftp_container/debian-installer/amd64/pxelinux.cfg/default