Installation

Shipmoor installs as one universal local executable named shipmoor. Free and Pro access is decided by the authorized account, not by a separate binary or installer.

Install

curl -fsSL https://dl.shipmoor.dev/install.sh | SHIPMOOR_VERSION=0.10.0 bash

The installer detects the supported macOS or Linux platform, verifies the archive’s SHA-256 checksum against the published manifest, and installs to ~/.shipmoor/bin/shipmoor. It prints the exact PATH update if that directory is not already available to your shell.

Supported archives are darwin-arm64, linux-amd64, and linux-arm64. Intel Macs (darwin-amd64) are not supported in this release. The installer requires curl, tar, python3, and either sha256sum or shasum.

Windows is not supported by the installer or shipmoor upgrade in this release. Download the archive manually from dl.shipmoor.dev instead.

Verify the current universal release:

shipmoor version
# shipmoor 0.10.0

Authorize the installation

Every installation requires account and device authorization for product commands. Run your intended command:

shipmoor scan --changed

If the device is unauthorized, the CLI starts device authorization and resumes the command after approval. New personal accounts receive 30 days of full Pro access without a card. See Sign in & device authorization.

Pin a version

The default channel is stable. Pin the universal launch release when reproducibility matters:

curl -fsSL https://dl.shipmoor.dev/install.sh | SHIPMOOR_VERSION=0.10.0 bash

The installer reads SHIPMOOR_VERSION in the bash process on the right side of the pipe. Placing the assignment before curl does not pass it to the installer.

Channels

stable is the default. Use staging only for early validation:

curl -fsSL https://dl.shipmoor.dev/install.sh | SHIPMOOR_CHANNEL=staging bash

Each channel resolves its own latest.json; one channel never falls through to the other. A version pin reads that version from the selected channel.

Older installer URLs

The older URLs remain compatibility shims and install the same universal binary:

curl -fsSL https://dl.shipmoor.dev/install-community-cli.sh | bash
curl -fsSL https://dl.shipmoor.dev/install-pro-cli.sh | bash

Installer choice does not grant or remove account capabilities. Prefer install.sh for new automation.

Upgrade

shipmoor upgrade
shipmoor upgrade --channel staging
shipmoor upgrade --version 0.10.0
shipmoor upgrade --non-interactive
shipmoor upgrade --json

upgrade verifies the new archive and atomically replaces the executable. It does not delete project configuration, Harness or Skills setup, reports, local evidence, or device state.

CI installation

Current self-managed CI supports Scan only and requires a scan-scoped SHIPMOOR_TOKEN in the environment. Installing the binary alone does not authorize a runner. See GitHub Actions.