Installation

Station provides multiple installation methods to fit your environment and preferences.

The easiest way to install Station is using our installation script:

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/cloudshipai/station/main/install.sh | bash

This script will:

  • Detect your platform automatically
  • Download the appropriate binary
  • Install to your system PATH
  • Verify the installation

Manual Installation

Build from Source

Requirements:

  • Go 1.21 or later
  • Git
git clone https://github.com/cloudshipai/station
cd station
make local-install

This will build Station and install it to ~/.local/bin/stn.

Verify Installation

After installation, verify Station is working:

stn version

You should see output similar to:

Station v0.1.0
Build: abc1234
Platform: linux/amd64

Next Steps

Now that Station is installed:

  1. Initialize Station - Set up your first environment
  2. Quick Start Guide - Create and run your first agent
  3. Architecture Overview - Understand how Station works

Troubleshooting

Permission Denied

If you get permission denied errors:

# Make sure the binary is executable
chmod +x /usr/local/bin/stn

# Or install to a user directory
mkdir -p ~/.local/bin
mv stn ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"

Command Not Found

If stn command is not found:

  1. Check if the binary is in your PATH:

    echo $PATH
which stn

  2. Add the installation directory to your PATH:

    # Add to your shell profile (.bashrc, .zshrc, etc.)
export PATH="/usr/local/bin:$PATH"

Platform Not Supported

Station supports:

  • Linux: x64, ARM64
  • macOS: Intel, Apple Silicon
  • Windows: x64

If your platform isn’t supported, try building from source or open an issue.

System Requirements

  • OS: Linux, macOS, Windows
  • Database: SQLite (built-in, no setup required)
  • Network: Outbound HTTPS for AI providers and MCP tool integrations