Makes sure fastlane-tools are up-to-date when running fastlane

This action will update fastlane to the most recent version - major version updates will not be performed automatically, as they might include breaking changes. If an update was performed, fastlane will be restarted before the run continues.

If you are using rbenv or rvm, everything should be good to go. However, if you are using the system's default ruby, some additional setup is needed for this action to work correctly. In short, fastlane needs to be able to access your gem library without running in sudo mode.

The simplest possible fix for this is putting the following lines into your ~/.bashrc or ~/.zshrc file:

export GEM_HOME=~/.gems
export PATH=$PATH:~/.gems/bin

After the above changes, restart your terminal, then run mkdir $GEM_HOME to create the new gem directory. After this, you're good to go!

Recommended usage of the update_fastlane action is at the top inside of the before_all block, before running any other action.

Supported platforms ios, android, mac
Author @milch, @KrauseFx

1 Example

before_all do
  # ...


Key Description Default
no_update Don't update during this run. This is used internally false
nightly DEPRECATED! Nightly builds are no longer being made available - Opt-in to install and use nightly fastlane builds false

* = default value is dependent on the user's system


To show the documentation in your terminal, run

fastlane action update_fastlane


It is recommended to add the above action into your Fastfile, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal

fastlane run update_fastlane

To pass parameters, make use of the : symbol, for example

fastlane run update_fastlane parameter1:"value1" parameter2:"value2"

It's important to note that the CLI supports primitive types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g. param:"1,2,3"). Hashes are not currently supported.

It is recommended to add all fastlane actions you use to your Fastfile.

Source code

This action, just like the rest of fastlane, is fully open source, view the source code on GitHub

Back to actions