altool plugin

fastlane Plugin Badge

Getting Started

This project is a fastlane plugin. To get started with fastlane-plugin-altool, add it to your project by running:

fastlane add_plugin altool


This plugin has configurable Apple ID and password but you probably don't want to hardcode that. You need to have Fastlane setup with FASTLANE_USER and FASTLANE_PASSWORD environmenal varibales setup. Fastlane will ask it when you run fastlane init but if not you have to set these variables.

You can set that easily for bash shell

$ export FASTLANE_USER="[email protected]";
$ export FASTLANE_PASSWORD="your_super_xecret_password";

You can do the same for your choice of shell if you aren't using bash.

About altool

This plugin can be used to upload IPA to iTunes Connect using altool.

Currently Fastlane deliver uses iTMSTransporter to upload an ipa files to iTunes Connect but there is slick way to do this using altool

This plugin can be used for uploading generated ipa file using Gym to iTunes Connect.

This plugin assume that, you already have that Fastlane setup and your details are configured as ENV variables in FASTLANE_USER and FASTLANE_PASSWORD by default.


You can configure this plugin using

        altool_username: ENV["FASTLANE_USER"],
        altool_password: ENV["FASTLANE_PASSWORD"],
        altool_app_type: "ios",
        altool_ipa_path: "./build/Your-ipa.ipa",
        altool_output_format: "xml",

Security Note:

This might print the username and password to build console in the commands, pipe the output to /dev/null or use similar approach so that fastlane don't print command to console.

Example Project Repo

This is a example project Altool-Demo available on GitHub which has its own README.

Run tests for this plugin

To run both the tests, and code style validation, run


To automatically fix many of the styling issues, use

rubocop -a

Issues and Feedback

For any other issues and feedback about this plugin, please submit it to this repository.


If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out