Skip to content

Installation

This step is only relevant if using the Inspector desktop app or Appium plugin formats.

Appium Plugin

Like all Appium plugins, the Inspector plugin can be installed and activated using the Appium command line.

  1. Install the plugin:

    1. For Appium 3:

      appium plugin install inspector
      
    2. For Appium 2 (last compatible version):

      appium plugin install --source=npm appium-inspector-plugin@2025.7.3
      
  2. Launch the Appium server with the plugin activated:

    appium --use-plugins=inspector --allow-cors
    
  3. Open the Inspector URL in your web browser:

    http://localhost:4723/inspector
    

Info

Make sure the above host URL and port match those of the Appium server. The server's base path value is irrelevant, as the plugin always uses the /inspector path.

Desktop App

The app can be downloaded from the Inspector's GitHub repository. Different file formats are provided for each supported platform. In addition to manual downloads, there are also unofficial ways to install the app using the command line.

Windows

Manual Download

It is recommended to download the .exe installer file, as it supports checking for updates.

Since the app is currently not signed, Windows will show a security warning to prevent you from opening the installer file. This can be bypassed with sufficient user permissions:

Handling installation warnings on Windows
  1. Right-click on the installer file and click Properties - a new window should open.
  2. Near the bottom of the window, there will be an Unblock checkbox - check it.
  3. Click OK.
  4. You should now be able to open the installer without issues.

Alternatively, you can also bypass this after having opened the installer:

  1. Upon opening the installer, the following warning will likely be shown. Appium Inspector Open Warning on Windows
  2. Click More info - a new button Run anyway should appear at the bottom.
  3. Click Run anyway - the installer window should open.

After following the installer steps, the Inspector app should be installed, and you should be able to open it without any warnings.

WinGet

It is possible to install the Inspector through WinGet. Please note that this method is only community-supported, and is not maintained by the Appium team.

winget install AppiumDevelopers.AppiumInspector

macOS

Manual Download

It is recommended to download the .dmg installer file, as it supports checking for updates.

Opening the file will open a simple window, showing icons for the Inspector and the Applications folder. Drag-and-drop the Inspector icon over the Applications icon to extract the app.

Since the app is currently not notarized, macOS will show various security warnings to prevent you from opening the app for the first time. These can be handled as described below:

Handling first-time warnings via command-line (any macOS)

Simply open your Terminal app and run the following command:

xattr -cr "/Applications/Appium Inspector.app"

You should now be able to open the app with no warnings.

Handling first-time warnings via GUI (macOS Sequoia or later)

Note

If your Mac has an Apple chip, you can skip these steps by installing Appium Inspector v2024.9.1 (which should not show any warnings), then using the update checker to upgrade to the most recent version.

  1. Upon opening the app, the following warning will be shown. Click Done. Appium Inspector Open Warning on macOS Sequoia
  2. Open macOS Settings -> Privacy & Security, then scroll down to the Security section. You should see the info text "Appium Inspector" was blocked to protect your Mac.
  3. Click Open Anyway.
  4. A prompt should appear - click Open Anyway again.
  5. A prompt should appear, requiring you to confirm the action using administrator user credentials.
  6. After confirming the action, the app should open.
Handling first-time warnings via GUI (macOS Sonoma or earlier)
  1. Upon opening the app, the following warning will be shown. Click OK. Appium Inspector Open Warning on macOS
  2. Open Finder -> Applications and find Appium Inspector.
  3. Control+Click/click with two fingers on Appium Inspector and click Open.
  4. A prompt should appear - click Open again.
  5. After accepting the prompt, the app should open.

Homebrew

It is possible to install the Inspector through Homebrew. Please note that this method is only community-supported, and is not maintained by the Appium team.

Warning

This method is deprecated and will be disabled on September 1st, 2026, since the app is not notarized.

brew install --cask appium-inspector

Linux

It is recommended to download the .AppImage file, as it supports checking for updates.

In order to open the file, its executable flag needs to be set first:

chmod a+x Appium-Inspector-<version>-linux-<arch>.AppImage

Afterwards, the app can be opened through the command line:

./Appium-Inspector-<version>-linux-<arch>.AppImage