Skip to main content

Installation

Learn how to install Spage on your system.

Prerequisites​

  • Go (1.24 or later)
  • Git (for cloning the repository)

Installation Methods​

The fastest way to install Spage is using our installation script. This will automatically detect your operating system and architecture, then download and install the latest version:

curl -sSL https://spage.dev/install.sh | bash

This script will:

  • Detect your OS and architecture automatically
  • Download the latest release from GitHub
  • Install the binary to /usr/local/bin/spage
  • Verify the installation

Method 2: Download Pre-built Binary​

You can also manually download the latest release from the GitHub releases page.

# Download for Linux (amd64)
curl -L https://github.com/AlexanderGrooff/spage/releases/latest/download/spage-linux-amd64 -o spage
chmod +x spage
sudo mv spage /usr/local/bin/

# Download for macOS (amd64)
curl -L https://github.com/AlexanderGrooff/spage/releases/latest/download/spage-darwin-amd64 -o spage
chmod +x spage
sudo mv spage /usr/local/bin/

# Download for Windows (amd64)
curl -L https://github.com/AlexanderGrooff/spage/releases/latest/download/spage-windows-amd64.exe -o spage.exe

Method 3: Install via Go​

If you have Go installed, you can install Spage directly:

go install github.com/AlexanderGrooff/spage@latest

Method 4: Build from Source​

Clone the repository and build from source:

git clone https://github.com/AlexanderGrooff/spage.git
cd spage
make build
sudo cp bin/spage /usr/local/bin/

Verify Installation​

After installation, verify that Spage is working correctly:

spage version

You should see output similar to:

Spage version v1.0.0

Next Steps​

Now that you have Spage installed, check out the Introduction to learn how to use it with your first playbook.