Installation

Shipmoor Team
June 11, 2026
2 min read

Shipmoor installs as one universal local executable named shipmoor. Community, IC, and Team behavior is decided by your account entitlements, not by which installer URL you used.

Install

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

The installer detects macOS or Linux, picks the matching archive (darwin-arm64, linux-amd64, or linux-arm64), verifies the archive’s SHA-256 against the published manifest, and installs to:

~/.shipmoor/bin/shipmoor

It requires curl, tar, python3, and either sha256sum or shasum. Intel Macs (darwin-amd64) and Windows are not supported for the scripted install in this release; Windows users install manually from dl.shipmoor.dev.

The older URLs install-community-cli.sh and install-pro-cli.sh still work and install the same universal binary. Installer choice never grants or removes entitlements.

Put it on your PATH

If ~/.shipmoor/bin isn’t already on your shell PATH, the installer prints the exact export PATH line to add. Then verify:

shipmoor version
# shipmoor 0.4.0

Channels and pinning

The default channel is stable. You can pin a version or switch to staging:

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

A channel never falls through to the other — stable and staging are independent.

Upgrading

Keep the binary current (this is also how a Community user moves to the IC-capable build):

shipmoor upgrade

upgrade fetches the channel manifest, verifies the new archive’s checksum, and atomically replaces the executable. It does not touch your project .shipmoor/, .shipmoor.yaml, or local ~/.shipmoor/ license and session state. For scripts, shipmoor upgrade --non-interactive gives deterministic output.

Upgrade exit codes:

CodeMeaning
0Success, or already current
2Usage error or unsupported platform
20Network / offline / download failure
21Checksum mismatch
22Permission or install-path error
23Atomic replacement failed; original install left intact

Sign in (for IC features)

Community scans work with no login. To unlock IC features such as Claim Check and Agent Skills:

shipmoor login
shipmoor whoami

See Sign in & licensing for how the local license works.

Last updated on June 11, 2026

Was this article helpful?

Your response is saved on this device.