1### Internet Explorer
 2
 3**Please Note:**  
 4This guide assumes that a system with Windows 10 has been set up.
 5
 6Microsoft provides
 7[free Windows 10 virtual machines](https://developer.microsoft.com/en-us/microsoft-edge/tools/vms/)
 8(that expire after 90 days) that can be used to test IE11 and Microsoft Edge
 9Legacy.
10
11To run the tests with Internet Explorer, follow these steps:
12
131. Set "Change the size of text, apps, and other items" to 100% in Windows
14   Display Settings.  
15   If the option is grayed out, make sure the graphics configuration allows
16   changing the scaling setting (see e.g.
17   [Parallels article #123951](https://kb.parallels.com/en/123951)).
18
192. Make sure the Internet Explorer `Zoom` level is set to `100%` so that the
20   native mouse events can be set to the correct coordinates.
21
223. Create a `.env` file in the same directory as
23   [docker-compose.yml](docker-compose.yml) and add the following environment
24   variables:
25
26   ```sh
27   SERVER_HOST=<DOCKER_HOST_IP>
28   SERVER_PORT=8080
29   WINDOWS_HOST=<WINDOWS_HOST_IP>
30   WINDOWS_ASSETS_DIR=C:\Users\<USERNAME>\Desktop\assets\
31   ```
32
33   Make sure that the `DOCKER_HOST_IP` is accessible from the Windows machine
34   and the `WINDOWS_HOST_IP` is accessible from a Docker container (see also the
35   [FAQ](FAQ.md)).  
36   Also make sure that `WINDOWS_ASSETS_DIR` points to a valid folder path and
37   ends with a backslash.
38
394. Edit the `example` host entry in [etc/windows.hosts](etc/windows.hosts) and
40   set its IP address to the `SERVER_HOST` IP defined in the `.env` file.
41
425. Copy [bin/webdriver.ps1](bin/webdriver.ps1) and
43   [etc/windows.hosts](etc/windows.hosts) to the same folder in the Windows
44   machine (e.g. the Desktop).  
45   Also copy the files in the `assets` directory to the folder defined as
46   `WINDOWS_ASSETS_DIR`.
47
486. Create a shortcut to `webdriver.ps1` (via "Right-Click" → "Create shortcut"),
49   then open the properties dialog for the shortcut (via "Right-Click" →
50   "Properties") and set the `Target` property to the following value:
51
52   ```bat
53   powershell -ExecutionPolicy ByPass -File webdriver.ps1
54   ```
55
56   Click "OK" to save the changes to the shortcut.
57
587. Double-Click on the webdriver shortcut to setup and start the servers.  
59   Allow `Microsoft WebDriver`, `nginx` and `MJPEGServer` to communicate on all
60   networks in the Windows Defender Firewall dialog.
61
628. Run the tests with Internet Explorer:
63   ```sh
64   docker-compose run --rm wdio conf/internet-explorer.js
65   ```