• English
  • Installation

    Shipplane Lite ships as a single binary (shipplane-lite).

    Supported platforms

    • macOS: arm64 (Apple Silicon) only — no Intel (x64) build.
    • Linux: x64 and arm64.

    Homebrew (macOS and Linux)

    brew install adityals/shipplane/shipplane-lite

    Manual download

    For systems without Homebrew (e.g. plain Linux). Swap linux-x64 for linux-arm64 on ARM hosts (Graviton, Raspberry Pi, etc.):

    curl -fL -o shipplane-lite https://github.com/adityals/shipplane/releases/latest/download/shipplane-lite-linux-x64
    chmod +x shipplane-lite
    sudo mv shipplane-lite /usr/local/bin/shipplane-lite

    Optional checksum verification (same arch swap applies):

    curl -fL -o shipplane-lite.sha256 https://github.com/adityals/shipplane/releases/latest/download/shipplane-lite-linux-x64.sha256
    sha256sum -c shipplane-lite.sha256

    Upgrade

    • Homebrew: brew upgrade shipplane-lite
    • Manual: re-run the curl command above — there's no in-binary self-update.

    macOS Gatekeeper

    The binary is unsigned. macOS flags it as from an unidentified developer on first run. Clear the quarantine flag once:

    xattr -d com.apple.quarantine ./shipplane-lite

    Run

    shipplane-lite

    Starts an HTTP server on port 3000 by default. Open http://localhost:3000 for the UI.

    See Configuration to change the host/port, load a config file, or seed workflows on startup, and CLI flags for --version and --no-sync.