1### Mobile Safari
 2
 3To run the tests with Mobile Safari on iOS Simulator, follow these steps:
 4
 51. Install [Xcode](https://itunes.apple.com/us/app/xcode/id497799835) from the
 6   Mac App Store.
 7
 82. Install the Xcode Command Line Tools:
 9
10   ```sh
11   xcode-select --install
12   ```
13
143. Install [Node.JS](https://nodejs.org/) and
15   [Carthage](https://github.com/Carthage/Carthage) via
16   [Homebrew](https://brew.sh/):
17
18   ```sh
19   brew install node carthage
20   ```
21
224. Make sure the necessary [Appium](https://appium.io/) dependencies for iOS
23   testing are installed:
24
25   ```sh
26   npx appium-doctor --ios
27   ```
28
295. Install [Appium](https://appium.io/) as global NPM package:
30
31   ```sh
32   npm install -g appium
33   ```
34
356. Add the `example` host to your `/etc/hosts` file:
36
37   ```sh
38   printf '127.0.0.1\t%s\n' example | sudo tee -a /etc/hosts
39   ```
40
417. Start `appium` with the provided helper script:
42
43   ```sh
44   bin/appium.sh
45   ```
46
478. Run the tests with Mobile Safari:
48
49   ```sh
50   docker-compose run --rm wdio conf/mobile-safari.js
51   ```
52
53   To run the tests in landscape orientation, provide the `ORIENTATION`
54   environment variable:
55
56   ```sh
57   ORIENTATION=LANDSCAPE docker-compose run --rm wdio conf/mobile-safari.js
58   ```
59
60   To use a different iOS device than defined in the config, provide the
61   `DEVICE_NAME` environment variable:
62
63   ```sh
64   DEVICE_NAME='iPad Pro (11-inch)' \
65    docker-compose run --rm wdio conf/mobile-safari.js
66   ```
67
68   To use a different iOS version than defined in the config, provide the
69   `PLATFORM_VERSION` environment variable:
70
71   ```sh
72   PLATFORM_VERSION=12.1 docker-compose run --rm wdio conf/mobile-safari.js
73   ```