Cloud Quickstart
Before wiring into CI, we recommend uploading a local build from your terminal to see the process working end-to-end. These steps should take you less than 5 minutes.
1. Install the Maestro CLI
We'll be using the maestro cloud command below to run your flows in the cloud, so start by installing the Maestro CLI if you haven't already:
curl -Ls "https://get.maestro.mobile.dev" | bash2. Retrieve your API Key and Project ID
Log in to the Maestro console, click Settings and copy your Project ID and generate an API Key.
3. Download the Samples
Use the download-samples command to download a sample app and Flow file:
maestro download-samplesYou can of course choose to upload your own app and Flow file, but we recommend using the samples first to see how it works!
4. Run your Flow in the cloud
Use the maestro cloud command to run your flow in the cloud. This command works the same whether you're running it locally or in CI.
Android
cd ./samples
maestro cloud --api-key <API_KEY> --project-id <PROJECT_ID> sample.apk android-flow.yamliOS
cd ./samples
maestro cloud --api-key <API_KEY> --project-id <PROJECT_ID> sample.zip ios-flow.yamlTo run any flow that depends on other files (like the advanced examples) you need to upload the full folder, so that Maestro has all of the files it needs. More information about subflows and what Flows to include can be found here.
To run both Android Flows in the cloud, you can for example run the following command outside of the samples folder.
maestro cloud samples/sample.apk samples5. View results in the console
A link to the Maestro console is printed out after your Flow is uploaded successfully. Click on the link to view the results of your upload. It may take a minute or so before your results are ready.
Congrats 🎉
Congrats, you just ran your first Maestro Flow in the cloud! 🙌
Now that's you've seen how this works locally, let's take a look at how this can be integrated into your CI workflows:
CI IntegrationLast updated
Was this helpful?