sota.io

Installation

Install the sota CLI to deploy and manage applications from your terminal.

System Requirements

  • macOS (Intel or Apple Silicon) or Linux (x86_64 or ARM64)
  • Windows users: use WSL2

Quick Install (Recommended)

curl -fsSL https://sota.io/install.sh | sh

This auto-detects your OS and architecture and installs the sota binary to /usr/local/bin.

To install to a custom location:

INSTALL_DIR=~/.local/bin curl -fsSL https://sota.io/install.sh | sh

Manual Download

Download the binary for your platform:

PlatformArchitectureDownload
macOSApple Silicon (M1/M2/M3/M4)sota-darwin-arm64
macOSIntelsota-darwin-amd64
Linuxx86_64sota-linux-amd64
LinuxARM64sota-linux-arm64

All releases are available on GitHub Releases.

After downloading:

chmod +x sota-*
sudo mv sota-* /usr/local/bin/sota

Install via Go

If you have Go 1.21+ installed:

go install github.com/sota-deploy/cli/cmd/sota@latest

Make sure $GOPATH/bin (usually ~/go/bin) is in your PATH.

Verify Installation

sota --version

Expected output:

sota version 1.0.0 (abc1234)

Authentication

After installation, authenticate with your sota.io account:

sota login

This opens your browser for OAuth authentication. After successful login, your credentials are stored at ~/.config/sota/credentials.json.

Configuration

The CLI stores configuration locally:

FilePurpose
~/.config/sota/credentials.jsonAuthentication tokens
.sota.jsonProject-level config (created by sota deploy)

Updating

Re-run the install script to update:

curl -fsSL https://sota.io/install.sh | sh

Or if installed via Go:

go install github.com/sota-deploy/cli/cmd/sota@latest

Next Steps