Spin Pro Logo

Install to macOS

Spin easily runs on any macOS machine that runs Docker Desktop. Getting started is as simple as installing Docker Desktop, then running a single command to install `spin`.

Install Docker Desktop

MacOS does not ship with Docker by default. To get Docker installed, you will need "Docker Desktop", which is the official desktop tool developed by Docker.

Learn how to install Docker Desktop →

Download and install spin

Once Docker is installed, you are now ready to install spin. Run the installer with this simple command in your terminal. No root permissions required.

Install spin to your machine (no root permissions required)
bash -c "$(curl -fsSL https://raw.githubusercontent.com/serversideup/spin/main/tools/install.sh)"

The above script will install spin at the user level in ~/.spin, using less than 300KB of storage.

Spin will prompt you if you want Spin to modify your PATH variable. If you press "Yes" follow the instructions on the screen. If you press "No" you will need to manually add Spin to your PATH.

Configuring your PATH variable manually

If you did not add spin to your PATH during the installation, you can manually add it to your PATH by adding this to your shell profile:

Run echo $0 in your terminal to figure out which shell you are using.
Add spin to your path
# Add this to `~/.zshrc` or `~/.bash_profile`
export PATH="$HOME/.spin/bin:$PATH"

In order to apply the changes to your current terminal session, you will need to run the source command.

Use the "source" command to apply your profile changes immediately
# If you're using ZSH
source ~/.zshrc

# If you're using Bash
source ~/.bash_profile

Validate it's working

You should be able to run this and get a result 🥳

Confirm spin is working correctly by getting the version
spin version

Activate your access

The Spin Pro template is a premium template that requires a license key to access. Follow the instructions below to get access to the easiest way to create and deploy Laravel applications.

Install to Windows

Spin is able to run on any Windows machine that supports Windows Subsystem Linux v2 (WLS2). This is a feature developed by Microsoft that allows you to run a Linux distribution on your Windows machine. It is supported in updated versions of Windows 10 and Windows 11.