Skip to content

Install on Linux

To use Vapor, you will need Swift 5.9 or greater. This can be installed using the CLI tool Swiftly provided by the Swift Server Workgroup (recommended), or the toolchains available on Swift.org.

Supported Distributions and Versions

Vapor supports the same versions of Linux distributions that Swift 5.9 or newer versions supports. Please refer to the official support page in order to find updated information about which operating systems are officially supported.

Linux distributions not officially supported may also run Swift by compiling the source code, but Vapor cannot prove stability. Learn more about compiling Swift from the Swift repo.

Install Swift

Visit the Swiflty website for instructions on how to install Swiftly and Swift on Linux. After that, install Swift with the following command:

Basic usage

$ swiftly install latest

Fetching the latest stable Swift release...
Installing Swift 5.9.1
Downloaded 488.5 MiB of 488.5 MiB
Extracting toolchain...
Swift 5.9.1 installed successfully!

$ swift --version

Swift version 5.9.1 (swift-5.9.1-RELEASE)
Target: x86_64-unknown-linux-gnu

Manual installation with the toolchain

Visit Swift.org's Using Downloads guide for instructions on how to install Swift on Linux.

Fedora

Fedora users can simply use the following command to install Swift:

sudo dnf install swift-lang

If you're using Fedora 35, you'll need to add EPEL 8 to get Swift 5.9 or newer versions.

Docker

You can also use Swift's official Docker images which come with the compiler preinstalled. Learn more at Swift's Docker Hub.

Install Toolbox

Now that you have Swift installed, let's install the Vapor Toolbox. This CLI tool is not required to use Vapor, but it helps to create new Vapor projects.

Homebrew

The Toolbox is distributed via Homebrew. If you do not have Homebrew yet, visit brew.sh for install instructions.

brew install vapor

Double check to ensure that the installation was successful by printing help.

vapor --help

You should see a list of available commands.

Makefile

If you want, you can also build the Toolbox from source. View the Toolbox's releases on GitHub to find the latest version.

git clone https://github.com/vapor/toolbox.git
cd toolbox
git checkout <desired version>
make install

Double check the installation was successful by printing help.

vapor --help

You should see a list of available commands.

Next

Now that you have installed Swift and the Vapor Toolbox, create your first app in Getting Started → Hello, world.