Files
firezone/rust/gui-client/docs/vm_testing.md
Reactor Scram 4106419ef1 refactor: rename windows-client to gui-client (#3721)
This may cause conflicts with all my other PRs but it has to happen.

```[tasklist]
- [ ] Update test names in branch protection (I don't think I have perms for this)
```
2024-02-22 20:21:27 +00:00

2.0 KiB

Testing the Firezone Windows client on a Windows server VM

Prepare VM

  1. Download and install Oracle VirtualBox https://www.virtualbox.org/wiki/Downloads
  2. Prepare a VM with 50 GB of hard drive, 2+ GB of RAM, and 2+ CPU cores (More resources will help Windows set up faster. We can reduce resources before testing Firezone)

Download VM image

Download the 64-bit ISO from https://www.microsoft.com/en-us/evalcenter/download-windows-server-2022

(Server 2019 requires a sign-up: https://info.microsoft.com/ww-landing-windows-server-2019.html)

You should get this file: SERVER_EVAL_x64FRE_en-us.iso

The Windows license is valid for 180 days

Install Windows Server

  1. In VirtualBox, mount the ISO as a CD/DVD
  2. Boot the VM and use F12, then 'c' to boot from CD/DVD
  3. When Windows asks what version to install, choose "Windows Server 2022 Standard Evaluation (Desktop Experience)
  4. Choose "Custom" to delete the old Windows install, if any, and re-install
  5. If there's any partition from a previous install, delete and recreate it
  6. Tell Windows to install on the primary partition

Windows first-time config

  1. Allow the PC to be "discoverable by other PCs and devices on this network", this might be needed for Firezone to work
  2. In the Server Manager, click "Manage", click "Server Manager Properties", check "Do not start Server Manager automatically at logon", and click "OK". Close Server Manager.
  3. Make any quality-of-life changes you want such as fixing the taskbar
  4. Open https://ifconfig.net/ in Edge and clear out the Edge first-time setup
  5. In the VirtualBox menu, click "Devices", click "Insert Guest Additions CD image", and then install the VirtualBox guest additions, so you can drag-and-drop files into the VM easily.
  6. Perform a clean shutdown from within the Windows VM.
  7. In VirtualBox, take a snapshot of the VM so you can roll back to this state after installing Firezone.

Testing Firezone

  1. Copy-paste an MSI built from CI/CD into the VM and install Firezone
  2. Test Firezone as usual