New to fastlane? Click here to open the installation & setup instructions first

1) Install the latest Xcode command line tools

xcode-select --install

2) Install fastlane

# Using RubyGems
sudo gem install fastlane -NV

# Alternatively using Homebrew
brew cask install fastlane

3) Navigate to your project and run

fastlane init

More Details


The Fastfile stores the automation configuration that can be run with fastlane.

The Fastfile has to be inside your ./fastlane directory.

Importing another Fastfile

Within your Fastfile you can import another Fastfile using 2 methods:


Import a Fastfile from a local path

import "../GeneralFastfile"

override_lane :from_general do
  # ...


Import from another git repository, which you can use to have one git repo with a default Fastfile for all your project

import_from_git(url: '')
# or
import_from_git(url: '',
               path: 'fastlane/Fastfile')

lane :new_main_lane do
  # ...

This will also automatically import all the local actions from this repo.


You should import the other Fastfile on the top above your lane declarations. When defining a new lane fastlane will make sure to not run into any name conflicts. If you want to overwrite an existing lane (from the imported one), use the override_lane keyword.

Load own actions from external folder

Add this to the top of your Fastfile.

actions_path '../custom_actions_folder/'

Using fastlane_require

If you're using a third party gem in your Fastfile, it is recommended to use fastlane_require instead of require. fastlane_require will:

  • Verify the gem is installed
  • Show installation instructions if not installed
  • Require the gem (like require does)


fastlane_require 'hike'

lane :release do
  # Do stuff with hike