App & Browser Testing Made Easy

Give your users a seamless experience by testing on 3000+ real devices and browsers. Don't compromise with emulators and simulators

Home Guide How to Download and Install Appium

How to Download and Install Appium

By Jash Unadkat, Community Contributor -

Appium is one of the most popular open-source automated mobile app testing tools. It allows developers or QA engineers to automate tests for native, hybrid, and mobile web applications. Appium uses the WebDriver protocol to automate iOS, Android, and Windows applications.

To understand the complete architectural implementation, start by setting up the Appium grid while this article aims to demonstrate the fundamental steps to get started with the Appium installation.

There are 2 methods to install Appium

  1. From the terminal using Node.js
  2. Directly from the Appium desktop client

Let’s discuss both methods in detail.

Method 1: Install Appium using Node.js

  • The first step is to verify whether Node.js is already installed in the system.
    To do so, open the terminal and run the following command:
node --version

If Node.js is already installed in the system, it’ll return the Node version, else it throws an error stating – ‘node is not recognized’, which means Node.js is not installed in the system.

Install Appium using Node.js

  • Choose the Node installer per the underlying operating system (Mac or Windows).
  • Windows users can verify the bit size (32-bit or 64-bit) by checking computer properties. Download the installer accordingly.
  • Once the installer is downloaded, run it and proceed with the installation. Define the path explicitly if required.
  • Once the installation is complete, restart the terminal and run the command -> node –version again. It will return the Node version.

This indicates the successful installation of Node.js. The Node.js installation also covers the installation of npm (node package manager).

Mac users can use the node -v and npm -v commands to verify the installation and version details.

  • To install Appium, run the following command.
npm install -g appium

The command above will download and install Appium. Once done, verify the Appium installation on macOS or Windows by running the command below:

appium --version

This will return the latest Appium version installed in your system.

  • To start the Appium server directly from the terminal, enter “appium” as a command. It will begin on the Appium server on Port number 4723.

With the steps above, we have successfully installed Appium using Node.js.

Method 2: Install Appium using Appium Desktop Client

Note: The Appium Desktop app is a powerful GUI for developers or QA engineers to run automated mobile tests. It is compatible with macOS, Windows, and Linux. The Appium Desktop app provides an intuitive user interface for controlling and configuring the Appium server.

Refer to this official resource for Appium Desktop to learn more about its features and offerings.

The installation of the Appium Desktop Client is bundled with Node runtime, so users do not need to install Node or npm explicitly.

To get started with Appium Desktop installation, follow the steps below:

1. Visit the official Appium site and Click on the Download Appium button

2. The Download button redirects the user to the GitHub page

3. From the GitHub page, Windows users need to download the .exe file, and Mac users need to download the .dmg fileInstall Appium on Windows and macOS

4. Once the Appium Desktop file for the respective OS is downloaded, start the installation by double-clicking on that file. Mac users must drag the Appium logo to the Applications folder to initiate the installation.

5. Once the installation is complete, start the Appium Desktop Client.

6. Users can start or stop the Appium server using this user interface. They can also configure their test environments using the Appium Desktop Client.

Before proceeding with any test scenarios, developers or QAs must consider installing and running Appium doctor. It is a tool that identifies and resolves common configuration issues in Node, iOS, and Android before Appium automation.

  • Install Appium Doctor using the following command:
npm install appium-doctor -g

Once the tool is installed, one can view the list of inspections available by running the command below:

appium-doctor -h

The image below represents the available commands one can use to verify the dependencies for a particular test environment before test automation.

Appium download

For example, before starting with automation on Android devices, QAs must run the command – appium doctor –android. This will display all missing and existing dependencies required for Android automation.

Running Appium Tests on the Cloud

Before test automation on mobile platforms, teams must have all dependencies and tools configured adequately on their systems. The above methods will guide QA engineers and developers seeking to get started with Appium automation on mobile devices.

  • Also, as mentioned earlier, teams or individuals must consider leveraging cloud-based platforms like BrowserStack that integrate with Appium. T
  • This will enable QA engineers to run Appium tests across various mobile devices in real user conditions.
  • BrowserStack’s cloud-based infrastructure makes Appium testing on real devices simple, intuitive, and effortless.

Sign up, configure the desired device-OS combination, and start testing.

Start Appium Testing Now

Appium Mobile App Testing

Featured Articles

Appium Best Practices Every Developer Must Know

Effective Locator Strategies in Appium

Curated for all your Testing Needs

Actionable Insights, Tips, & Tutorials delivered in your Inbox
By subscribing , you agree to our Privacy Policy.
thank you illustration

Thank you for Subscribing!

Expect a curated list of guides shortly.