From cdb048a4c2caa9df4d6cf109101c36bc78720672 Mon Sep 17 00:00:00 2001
From: Pierre Lune Bellec <pierre.bellec@gmail.com>
Date: Mon, 27 Oct 2025 14:29:37 -0400
Subject: [PATCH] First draft of the tutorial.

---
 misc/vpn_udem.md | 79 ++++++++++++++++++++++++++++++++++++++++++++++++
 myst.yml         |  5 ++-
 2 files changed, 83 insertions(+), 1 deletion(-)
 create mode 100644 misc/vpn_udem.md

diff --git a/misc/vpn_udem.md b/misc/vpn_udem.md
new file mode 100644
index 0000000..97560c3
--- /dev/null
+++ b/misc/vpn_udem.md
@@ -0,0 +1,79 @@
+# UdeM VPN (Windows VM on Ubuntu)
+
+## 🛠️ Part 1: Create a Clean Windows 10 VM (LTSC Recommended)
+
+### 1. **Download Windows 10 LTSC (64-bit)**
+
+* Visit: [https://www.microsoft.com/en-us/evalcenter/evaluate-windows-10-enterprise](https://www.microsoft.com/en-us/evalcenter/evaluate-windows-10-enterprise)
+* Select **LTSC 2021**, 64-bit ISO
+* Download and save the `.iso` to your `~/Downloads` folder
+
+---
+
+### 2. **Install VirtualBox**
+
+```bash
+sudo apt update
+sudo apt install virtualbox
+```
+
+---
+
+### 3. **Create the VM in Bash**
+
+```bash
+VM_NAME="WindowsVPN"
+VM_DIR="$HOME/VirtualBox VMs/$VM_NAME"
+ISO_PATH="$HOME/Downloads/your-downloaded-iso.iso"  # replace with real filename
+DISK_SIZE=51200  # MB
+RAM=4096
+BRIDGE_ADAPTER=$(ip route | grep default | awk '{print $5}')
+
+VBoxManage createvm --name "$VM_NAME" --ostype "Windows10_64" --register
+VBoxManage modifyvm "$VM_NAME" \
+  --memory $RAM --vram 128 \
+  --boot1 dvd --graphicscontroller vmsvga \
+  --nic1 bridged --bridgeadapter1 "$BRIDGE_ADAPTER" \
+  --firmware efi
+
+VBoxManage createhd --filename "$VM_DIR/$VM_NAME.vdi" --size $DISK_SIZE
+VBoxManage storagectl "$VM_NAME" --name "SATA Controller" --add sata --controller IntelAhci
+VBoxManage storageattach "$VM_NAME" --storagectl "SATA Controller" --port 0 --device 0 --type hdd --medium "$VM_DIR/$VM_NAME.vdi"
+VBoxManage storageattach "$VM_NAME" --storagectl "SATA Controller" --port 1 --device 0 --type dvddrive --medium "$ISO_PATH"
+VBoxManage startvm "$VM_NAME"
+```
+
+---
+
+## 🩟 Part 2: Install and Configure Windows
+
+### 4. **Install Windows**
+
+* Go through the install steps
+* Choose "I don’t have a product key"
+* Select **Windows 10 Enterprise Evaluation**
+* Skip updates and telemetry
+* Log in and reach the desktop
+
+---
+
+### 5. **Install Guest Additions (Clipboard & Resolution Fixes)**
+
+* In the VM: `Devices → Insert Guest Additions CD`
+* Run the installer from File Explorer
+* Reboot the VM
+
+---
+
+### 6. **Enable Copy-Paste Between Host and VM**
+
+On Ubuntu:
+
+```bash
+VBoxManage controlvm "$VM_NAME" clipboard bidirectional
+VBoxManage controlvm "$VM_NAME" draganddrop bidirectional
+```
+
+Or from GUI:
+
+* VM Settings → Gen
diff --git a/myst.yml b/myst.yml
index 0677dd9..f2a7dd3 100644
--- a/myst.yml
+++ b/myst.yml
@@ -14,12 +14,15 @@ project:
     - file: content/manifesto.md
     - file: content/coc.md
     - file: content/members.md
-    - file: content/contributing.md  
+    - file: content/contributing.md
     - title: Alliance Canada
       children:
         - file: alliance_canada/quick_start.md
         - file: alliance_canada/advanced_usage.md
         - file: alliance_canada/resource_tracking.md
+    - title: Misc
+      children:
+        - file: misc/vpn_udem.md
 site:
   template: book-theme
   options: