Maestro by mobile.dev
Ask or search…
K

Installing Maestro

Installing the CLI

Using Windows? Follow this guide to get set up on a Windows machine: Installing Maestro on Windows
Run the following command to install Maestro on Mac OS, Linux or Windows (WSL):
curl -Ls "https://get.maestro.mobile.dev" | bash

Upgrading the CLI

Simply run the installation script again:
curl -Ls "https://get.maestro.mobile.dev" | bash

Installing a specific version of Maestro

To install a specific version, declare a MAESTRO_VERSION property and run the same installation command as before:
export MAESTRO_VERSION={version}; curl -Ls "https://get.maestro.mobile.dev" | bash

Installing a specific version of Maestro in a Dockerfile

Define a variable for the version you want to install
ENV MAESTRO_VERSION {version}
Then download and install Maestro and add it to your path
RUN mkdir -p /opt/maestro && \
wget -q -O /tmp/${MAESTRO_VERSION} "https://github.com/mobile-dev-inc/maestro/releases/download/cli-${MAESTRO_VERSION}/maestro.zip" && \
unzip -q /tmp/${MAESTRO_VERSION} -d /opt/ && \
rm /tmp/${MAESTRO_VERSION}
ENV PATH=/opt/maestro/bin:${PATH}

Connecting to Your Device

iOS
Android
Before running Flows on iOS Simulator, install Facebook IDB tool
brew tap facebook/fb
brew install facebook/fb/idb-companion
Note: At the moment, Maestro does not support real iOS devices
maestro test will automatically detect and use any local emulator or USB-connected physical device.

Homebrew support

We no longer recommend using homebrew to manage your maestro installation and instead recommend the installation script above. To upgrade your maestro installation that was installed via Homebrew we recommend uninstalling it and then reinstalling it using the official instructions:
brew uninstall maestro
curl -Ls "https://get.maestro.mobile.dev" | bash