Sage
Docs / Basics

Installation

Sage is distributed as a single binary with nothing else to install. Builds are available for Linux, macOS and FreeBSD on amd64 and arm64.

Quick install

$ curl -fsSL https://eu.gateway.fivestats.org/install.sh | sh

The script works out your operating system and architecture, downloads the archive of the latest release, checks its SHA-256 sum and puts sage into /usr/local/bin. You can read it before running it: install.sh.

From an archive

Every release has archives for each platform, named after the version:

$ curl -LO https://eu.gateway.fivestats.org/releases/0.5.0/sage-0.5.0-linux-amd64.tar.gz
$ tar -xzf sage-0.5.0-linux-amd64.tar.gz
$ sudo install -m 755 sage /usr/local/bin/

From source

Building needs Go 1.22 or newer:

$ curl -LO https://eu.gateway.fivestats.org/releases/0.5.0/sage-0.5.0.tar.gz
$ tar -xzf sage-0.5.0.tar.gz && cd sage-0.5.0
$ go build -o sage ./cmd/sage

Verify

$ sage --version
sage 0.5.0 (linux/amd64)

Shell completion

$ sage completion bash | sudo tee /etc/bash_completion.d/sage > /dev/null

Completion is also available for zsh and fish. Run sage completion --help for where to put the files.