Skip to end of metadata
Go to start of metadata

Plugin Information

View TestFairy on the plugin site for more information.

The current version of this plugin may not be safe to use. Please review the following warnings before use:

This plugin helps you to upload Android APKs or iOS IPA files to

How to use

Select TestFairy iOS/Android Uploader from Add post-build action menu


Job Configuration:

* The API Key can be found in your account settings   

To make sure Jenkins also uploads your iOS dSYMs to TestFairy, configure the Xcode that builds the app on the Jenkins server to run a special script. Follow these instructions.

The resulted TestFairy links will be listed in the console output

Important for Advanced Uploader only: 
  • You should configure the "Path To Keystore file" and the corresponding storepass alias.
  • You should configure "TestFairy Android Environment" on http://localhost:8080/configure for example:

Custom changelog

In order to add your own changelog or comments, please create a text file in the following location: $JENKINS_HOME/jobs/$JOB_NAME/builds/$BUILD_ID/testfairy_change_log

The content of this file will override the default changelog.

Private Cloud / On-Premise support 

In case you are using our Private Cloud or On-Premise product

please define an TESTFAIRY_UPLOADER_SERVER environment variable.
You can do it by going to Manage Jenkins => Configure

Under section Global Properties, check Environment variables checkbox. Now Jenkins allow us to add key and value pairs.

The name should be TESTFAIRY_UPLOADER_SERVER and the value will be your server domain.

The following line should be printed at your next job console output: 
"The server will be"


This plugin was developed and open sourced by TestFairy


The past plugin was developed by 3Pillar Global


  1. Any idea how to get SCM changes into the comments field?

    I am using SVN.

    I tried:

    ${CHANGES, showPaths=true}

    But it doesn't work

    1. You should do nothing to use the SVN changelog (it will work automatically).

      But if you want to override it.

      Just add this file $JENKINS_HOME/jobs/$JOB_NAME/builds/$BUILD_ID/testfairy_change_log, TestFairy will use his content as yours changelog.

      1. How do you do this?
        Edit: Figured it out with a post build shell script.

  2. Do you still work slave node? 

    master: Linux 
    slave: Win7 

    in this environment, we tried to upload the apk made ​​in the Job to be done in slave node, invalid file path expception will occur (even an absolute path)

  3. Can we upload multiple file at a time? and use regular expression for file path?

  4. Please add support for TokenMacro expansion or at least environment variables or build parameters.

    The release notes section is less than useless without that. Would be nice to use it for tester groups as well.