Python Server Side Example

Unlike the remotely connected Appium setup, parallel test script execution is possible in the cloud. The scripts are run in the cloud rather than through an active connection from remote machine to the cloud. For this reason scripts don’t need to use testdroid_* capabilities at all and instead use only Appium capabilities.

When using server-side Appium execution, tests can be run using standard Appium on hundreds of devices in parallel without any need for complex set-ups at the client side.

NOTE! Server side Appium test runs on Bitbar Testing are available starting from SOLO plan. Please contact for more information.


This example works for both Android and iOS devices.

Dependencies for running locally:

Running the scripts

In make sure that the ${TEST} variable has correct name in it. This is the name of the python script file of the actual tests. To get screenshots and test results visible to the cloud, make sure screenshots can be found from “screenshots” directory at the root of the test files directory. This applies also to JUnit result files, which have to be named as “TEST-all.xml” and also located in the root of the test files directory.

Running in cloud

Test and additional needed files need to be sent to cloud as a zip package. is an example package. This only needs to be modified by renaming or to depending which environment is being tested.

Note, needs to always be at the root of the package.

An example zip package content could look like this.

  Length      Date    Time    Name
---------  ---------- -----   ----
    13042  2015-02-06 09:57   Appium-Python-Client-0.13.tar.gz
     2641  2015-03-11 15:27
     1736  2016-08-19 19:44
     4864  2015-03-11 15:07
    15922  2015-02-13 18:11   xmlrunner.tar.gz
---------                     -------
    38205                     5 files

On Bitbar Testing:

  • Create a new Appium Server side project (either iOS or Android)
  • Create a new test run inside of new server side project
    • Upload tested application (apk/ipa) in the “Application” step
    • Upload the above created zip using the “Upload test file” step
    • Choose the device group to use or create a new group for this run
    • Start testrun

Running locally

  • Launch Appium server as normally when running local Appium tests. Appium for iOS needs device id in launch parameters.
  • In comment out or remove the lines between ##### Cloud testrun dependencies start and ##### Cloud testrun dependencies end.
  • assumes the tested apk/ipa is named as application.apk or application.ipa and is located at the root of the working directory. Alternatively update to use another path.
  • Launch tests by running the script