mirror of
https://github.com/outbackdingo/firezone.git
synced 2026-01-27 18:18:55 +00:00
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) ```
2.0 KiB
2.0 KiB
Testing the Firezone Windows client on a Windows server VM
Prepare VM
- Download and install Oracle VirtualBox https://www.virtualbox.org/wiki/Downloads
- 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
- In VirtualBox, mount the ISO as a CD/DVD
- Boot the VM and use F12, then 'c' to boot from CD/DVD
- When Windows asks what version to install, choose "Windows Server 2022 Standard Evaluation (Desktop Experience)
- Choose "Custom" to delete the old Windows install, if any, and re-install
- If there's any partition from a previous install, delete and recreate it
- Tell Windows to install on the primary partition
Windows first-time config
- Allow the PC to be "discoverable by other PCs and devices on this network", this might be needed for Firezone to work
- 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.
- Make any quality-of-life changes you want such as fixing the taskbar
- Open
https://ifconfig.net/in Edge and clear out the Edge first-time setup - 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.
- Perform a clean shutdown from within the Windows VM.
- In VirtualBox, take a snapshot of the VM so you can roll back to this state after installing Firezone.
Testing Firezone
- Copy-paste an MSI built from CI/CD into the VM and install Firezone
- Test Firezone as usual