vapor-docs/2.0/docs/getting-started/install-on-macos.md

63 lines
1.7 KiB
Markdown

# Install on macOS
To use Vapor on macOS, you just need to have Xcode 8 installed.
## Install Xcode
Install [Xcode 8](https://itunes.apple.com/us/app/xcode/id497799835?mt=12) from the Mac App Store.
[![Xcode 8](https://cloud.githubusercontent.com/assets/1342803/18537674/2ddd8e9c-7ad5-11e6-9bc2-7155d57d20ec.png)](https://itunes.apple.com/us/app/xcode/id497799835?mt=12)
### 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:
```sh
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.
```sh
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
For more information on installing Homebrew, visit [brew.sh](https://brew.sh).
### Add Homebrew Tap
Vapor's Homebrew tap will give your Homebrew installation access to all of Vapor's macOS packages.
```sh
brew tap vapor/homebrew-tap
brew update
```
### Install
Now that you've added Vapor's tap, you can install Vapor's toolbox and dependencies.
```sh
brew install vapor
```
## Next
Learn more about the Vapor toolbox CLI in the [Toolbox section](toolbox.md) of the Getting Started section.
## Swift.org
Check out [Swift.org](https://swift.org)'s extensive guides if you need more detailed instructions for installing Swift 3.1.