Install on macOS

To use Vapor on macOS, you just need to have Xcode 8 installed.

Install Xcode

Install Xcode 8 from the Mac App Store.

Xcode 8

Open Xcode

After Xcode 8 has been downloaded, you must open it to finish the installation. This may take a while.

Verify Swift Installation

Double check the installation was successful by running:

eval "$(curl -sL check2.vapor.sh)"

Install Vapor

Now that you have Swift 3.1, let's install the Vapor toolbox.

The toolbox includes all of Vapor's dependencies as well as a handy CLI tool for creating new projects.

Install Homebrew

If you don't already have Homebrew installed, install it! It's incredibly useful for installing software dependencies like OpenSSL, MySQL, Postgres, Redis, SQLite, and more.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

For more information on installing Homebrew, visit brew.sh.

Add Homebrew Tap

Vapor's Homebrew tap will give your Homebrew installation access to all of Vapor's macOS packages.

brew tap vapor/homebrew-tap
brew update


Now that you've added Vapor's tap, you can install Vapor's toolbox and dependencies.

brew install vapor


Learn more about the Vapor toolbox CLI in the Toolbox section of the Getting Started section.


Check out Swift.org's extensive guides if you need more detailed instructions for installing Swift 3.1.