Hi all, in this article, we will learn how to install Appium on MAC OS with all external tools and components. I will try to explain each step respectively. Let’s start.

Step-1: Install JAVA JDK

You should go to the below link and install JAVA JDK for MAC OS.


After installation check below path to find JAVA HOME, for my version it is as shown below.



Then set JAVA HOME on your Mac as shown below:

Then, run below command to check your JAVA HOME.

Note that this sets JAVA_HOME only for a session. If you want it to persist always for all sessions, you need to add the command to your ~/.profile file.

  • Open a new terminal window.
  • Open a .profile file by typing: emacs .profile
  • Type below commands:
    • JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_192.jdk/Contents/Home
    • export JAVA_HOME;
    • Then, do the (ctrl-x, ctrl-s; ctrl-x, ctrl-c) to save and exit emacs.
    • Open a new terminal and run below command:
      • $JAVA_HOME/bin/java -version
      • You should see below screenshot with your java version number.

java version on mac

If you have MAC OS 10.5 or newer you can just use below command:

then source the profile file:

Then check the result:

Step-2: Install Android Studio

You need to go to the below address, download Android Studio for Mac and do the followings as stated below.


[1] To install Android Studio on your Mac, proceed as follows:

  1. Launch the Android Studio DMG file.
  2. Drag and drop Android Studio into the Applications folder, then launch Android Studio.
  3. Select whether you want to import previous Android Studio settings, then click OK.
  4. The Android Studio Setup Wizard guides you through the rest of the setup, which includes downloading Android SDK components that are required for development.

android studio for mac

When u open and select the default settings, Android Studio will start to download the required libraries as shown below.

android studio download packages on mac


Do below settings in .profile file. Open a terminal and type

Then, paste below commands: (Change your user name! Not use my username “onur”).

Then, run below commands to verify the settings:

After that, check your settings and installations. Open a terminal and type “sdkmanager –list”.

And type “uiautomatorviewer” to check uiautomatorviewer is working properly.

Step-3: Install Homebrew

Open a terminal window and run below command to install brew:

home brew installation on mac

Close all terminal windows and reopen a terminal window and check the Android home by typing below command:


Step-4: Install Node.js and npm

Go to https://nodejs.org/en/download/ download and install node package. It is pretty straight forward.

To see if Node is installed, type in node -v Terminal.

To see if NPM is installed, type in npm -v Terminal.

In order to update Node and NPM, you can use Homebrew to update these two:

  1. Make sure Homebrew has the latest version of the Node package. In Terminal type brew update
  2. Upgrade Node: brew upgrade node

Step-5: Install Appium on Terminal

In order to install appium via terminal you need to run below commands:

Note: If you face with permission problems as shown below, please run below commands on terminal. [owner] is your user name. To find it, you can run below command first:


Then, try to run appium installation commands. They will work as shown below.


Step-6: Install Carthage

First, change the permissions as shown below commands:

Then, install Carthage:


And run below command:


If everything is successful, then try to start appium as below commands:




Step-7: Download Appium Desktop

Let’s go this link: https://github.com/appium/appium-desktop/releases/  and download appium for mac. You should click and download .dgm file. For example, “Appium-1.10.0.dmg“. When the download finishes, double click the .dgm file and drag and drop the Appium into Applications as shown below.

appium installation on mac

Then, you will see appium logo in your applications when you click to the launchpad icon as shown below.

appium mac

Step-8: Install libimobiledevice

In order to run our tests on real devices, we need to install libimobiledevice dependency by executing brew install libimobiledevice command on terminal.


Step-9: Install XCode

Download Xcode from Mac AppStore and install Xcode. Once installed, Launch Xcode and select Xcode > Preferences > Components to install the simulators that you might want to test against.


Step-10: Install Authorize-ios

authorize-ios is a utility which pre-authorizes to run UIAutomation scripts on iOS devices. We need this tool for running our tests on real devices.

In order to install it, open a terminal window and run the following command:


Step-11: Install ios-deploy

To deploy our apps to our devices by using ios-deploy.  We can install and debug apps from the command line without using Xcode.

In the terminal, enter the following:


Step-12: Install ideviceinstaller

ideviceinstaller helps us to install, uninstall, upgrade, archive, restore and enumerate installed or archived apps. We need this utility to run tests on real devices. In order to install it, run below commands:


Step-13: Install ios_webkit_debug_proxy

In order to access web views on real iOS devices, we need to install this tool. Run the below command:


Step-14: Install Appium Doctor

Appium Doctor checks most of the preconditions for appium to run successfully. In order to install it, run below command:


Let’s run appium doctor and see what we should do for Appium.


Step-15: Install Maven

It is used for building and managing Java-based projects by using dependencies. Open a terminal and run below command.

Then, check the installation with below command:


Then, add the maven path to your profile file.

All tools for iOS and Android automation for MAC environment are ready now. We can go on to start Android and iOS test automation from here.


[1] – https://developer.android.com/studio/install