> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudshipai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Station CLI on your system

## Quick Install

The fastest way to install Station is using our install script:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/cloudshipai/station/main/install.sh | bash
```

This script:

1. Detects your platform (Linux/macOS/Windows) and architecture (amd64/arm64)
2. Downloads the latest release from GitHub
3. Installs the `stn` binary to `~/.local/bin/` or `/usr/local/bin/`
4. Adds the binary to your PATH if needed

## Manual Installation

### From GitHub Releases

Download the appropriate binary for your platform from [GitHub Releases](https://github.com/cloudshipai/station/releases):

<Tabs>
  <Tab title="macOS (Apple Silicon)">
    ```bash theme={null}
    # Download
    curl -LO https://github.com/cloudshipai/station/releases/latest/download/station_darwin_arm64.tar.gz

    # Extract
    tar -xzf station_darwin_arm64.tar.gz

    # Install
    mv stn ~/.local/bin/
    chmod +x ~/.local/bin/stn
    ```
  </Tab>

  <Tab title="macOS (Intel)">
    ```bash theme={null}
    # Download
    curl -LO https://github.com/cloudshipai/station/releases/latest/download/station_darwin_amd64.tar.gz

    # Extract
    tar -xzf station_darwin_amd64.tar.gz

    # Install
    mv stn ~/.local/bin/
    chmod +x ~/.local/bin/stn
    ```
  </Tab>

  <Tab title="Linux (x64)">
    ```bash theme={null}
    # Download
    curl -LO https://github.com/cloudshipai/station/releases/latest/download/station_linux_amd64.tar.gz

    # Extract
    tar -xzf station_linux_amd64.tar.gz

    # Install
    mv stn ~/.local/bin/
    chmod +x ~/.local/bin/stn
    ```
  </Tab>

  <Tab title="Linux (ARM64)">
    ```bash theme={null}
    # Download
    curl -LO https://github.com/cloudshipai/station/releases/latest/download/station_linux_arm64.tar.gz

    # Extract
    tar -xzf station_linux_arm64.tar.gz

    # Install
    mv stn ~/.local/bin/
    chmod +x ~/.local/bin/stn
    ```
  </Tab>
</Tabs>

### From Source

Build Station from source using Go 1.21+:

```bash theme={null}
# Clone the repository
git clone https://github.com/cloudshipai/station.git
cd station

# Build with UI embedded
make build-with-ui

# Install to PATH
mv bin/stn ~/.local/bin/
```

## Verify Installation

Check that Station is installed correctly:

```bash theme={null}
stn --version
```

You should see output like:

```
stn version v0.1.0
```

## PATH Configuration

If `stn` is not found after installation, add `~/.local/bin` to your PATH:

<Tabs>
  <Tab title="Bash">
    ```bash theme={null}
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Zsh">
    ```bash theme={null}
    echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="Fish">
    ```bash theme={null}
    fish_add_path ~/.local/bin
    ```
  </Tab>
</Tabs>

## System Requirements

| Requirement      | Minimum                     | Recommended           |
| ---------------- | --------------------------- | --------------------- |
| **OS**           | Linux, macOS, Windows (WSL) | Linux, macOS          |
| **Architecture** | x64, ARM64                  | ARM64 (Apple Silicon) |
| **RAM**          | 512MB                       | 2GB                   |
| **Disk**         | 100MB                       | 500MB                 |
| **Docker**       | Optional                    | Required for `stn up` |

## Upgrading

To upgrade to the latest version:

```bash theme={null}
# Re-run the install script
curl -fsSL https://raw.githubusercontent.com/cloudshipai/station/main/install.sh | bash

# Or if using stn up
stn up --upgrade
```

## Uninstalling

To remove Station:

```bash theme={null}
# Remove binary
rm ~/.local/bin/stn

# Remove configuration (optional)
rm -rf ~/.config/station/
```

## Next Steps

<Card title="Configuration" icon="gear" href="/station/configuration">
  Configure Station with your AI provider
</Card>