Quick note that this would be really helpful for other teams too — any chance the VM image/setup instructions could be made available if/when complete? ✨

In T340625#8973366, @TheresNoTime wrote:

Quick note that this would be really helpful for other teams too — any chance the VM image/setup instructions could be made available if/when complete? ✨

This a rough guide from our internal documentation on the topic. Something to build up on. At least tested with one other developer. The installation of Virtualbox can add several layers of complexity depending on setup, but that's something else.

Tested with Ubuntu 20.04 and 22.04

• Install Virtualbox
  • e.g. sudo apt install virtualbox virtualbox-qt virtualbox-dkms
• Get the Windows 10 Edge VM image ( from archive.org ) and extract the .zip file
• Open Virtualbox and import the extracted .ova image with File > Import Appliance
  • On the Appliance Settings step change Sound Card to Intel HD Audio
• Start the MSEdge - Win10 VM ( can take some time on the first run )
• Enable sound output
  • In the VirtualBox top menu: Devices > Audio > Audio Output
• To enable bidirectional clipboard
  • Install VirtualBox Guest Additions
    • VM reboot might be necessary
  • Enable the option in the VirtualBox top menu: Devices > Shared Clipboard > Bidirectional
• If you want to access the wiki from your local dev environment on your machine you have to add the host address to the VM’s host file.
  • Click the Start button
  • Type cmd and right click on Command Prompt and Run as administrator to open the command prompt
  • Type notepad %SystemRoot%\system32\drivers\etc\hosts and submit to edit the hosts file
  • Add a line to the end with 10.0.2.2 dev.wiki.local.wmftest.net save and exit
  • ( replace dev.wiki.local.wmftest.net with the host address of your local wiki )
• Install browsers/screenreaders you want to test with
  • Download and install Firefox
  • Download and install Chrome
  • Download and install NVDA
  • Download and install JAWS
    • Note: There is a 40 min trial period after 40 mins of using the app you have to restart the machine. Or use a snapshot to avoid restarts, see below.

Pro Tip: Use a Snapshot
When you’re finished and happy with the setup you can create a Snapshot. It's like hibernating the machine. This way you spare long shutdowns and starts and it also allows you to use the 40min of the JAWS trial version anew without reboot.

For the snapshot go to the VirtualBox top menu Machine > Take Snapshot. Now when you want to shutdown the machine choose File > Close… > Power off machine with the checkbox to restore the snapshot.