1### Edge Legacy
 2
 3**Please Note:**  
 4This guide assumes that a system with Windows 10 and Microsoft Edge Legacy has
 5been set up.
 6
 7Microsoft provides
 8[free Windows 10 virtual machines](https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/)
 9(that expire after 90 days) that can be used to test IE11 and Microsoft Edge
10Legacy.
11
12To be able to use both the new and legacy Edge on the same machine, please read
13[how to access the old version of Microsoft Edge](https://docs.microsoft.com/en-us/deployedge/microsoft-edge-sysupdate-access-old-edge).
14
15Please also note that the scripted installation of
16[Microsoft WebDriver for Microsoft Edge Legacy](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/)
17requires `17763` as minimum Windows build version.
18
19To run the tests with Edge Legacy, follow these steps:
20
211. Create a `.env` file in the same directory as
22   [docker-compose.yml](docker-compose.yml) and add the following environment
23   variables:
24
25   ```sh
26   SERVER_HOST=<DOCKER_HOST_IP>
27   SERVER_PORT=8080
28   WINDOWS_HOST=<WINDOWS_HOST_IP>
29   WINDOWS_ASSETS_DIR=C:\Users\<USERNAME>\Desktop\assets\
30   ```
31
32   Make sure that the `DOCKER_HOST_IP` is accessible from the Windows machine
33   and the `WINDOWS_HOST_IP` is accessible from a Docker container (see also the
34   [FAQ](FAQ.md)).  
35   Also make sure that `WINDOWS_ASSETS_DIR` points to a valid folder path and
36   ends with a backslash.
37
382. Edit the `example` host entry in [etc/windows.hosts](etc/windows.hosts) and
39   set its IP address to the `SERVER_HOST` IP defined in the `.env` file.
40
413. Copy [bin/webdriver.ps1](bin/webdriver.ps1) and
42   [etc/windows.hosts](etc/windows.hosts) to the same folder in the Windows
43   machine (e.g. the Desktop).  
44   Also copy the files in the `assets` directory to the folder defined as
45   `WINDOWS_ASSETS_DIR`.
46
474. Create a shortcut to `webdriver.ps1` (via "Right-Click" → "Create shortcut"),
48   then open the properties dialog for the shortcut (via "Right-Click" →
49   "Properties") and set the `Target` property to the following value:
50
51   ```bat
52   powershell -ExecutionPolicy ByPass -File webdriver.ps1
53   ```
54
55   Click "OK" to save the changes to the shortcut.
56
575. Double-Click on the webdriver shortcut to setup and start the servers.  
58   Allow `Microsoft WebDriver`, `nginx` and `MJPEGServer` to communicate on all
59   networks in the Windows Defender Firewall dialog.
60
616. Run the tests with Edge Legacy:
62   ```sh
63   docker-compose run --rm wdio conf/edge-legacy.js
64   ```