Operator CLI

Get plexctl

plexctl is the operator client for the plexsphere control plane. Grab a prebuilt binary for your platform, verify it against the published checksums, and put it on your PATH.

Detecting your platform — or pick one from the list below.

Verify & install

Confirm the checksum before trusting the binary, then drop it on your PATH.

# Linux — verify against the published manifest, then install sha256sum --ignore-missing -c SHA256SUMS chmod +x plexctl-linux-amd64 sudo install -m 0755 plexctl-linux-amd64 /usr/local/bin/plexctl plexctl --version
# macOS — shasum ships in place of sha256sum shasum -a 256 --ignore-missing -c SHA256SUMS chmod +x plexctl-darwin-arm64 sudo install -m 0755 plexctl-darwin-arm64 /usr/local/bin/plexctl plexctl --version
On macOS the first run may be blocked by Gatekeeper. Clear the quarantine flag with xattr -d com.apple.quarantine plexctl, or approve the binary under System Settings → Privacy & Security.

Build from source

Prefer to build it yourself, or need an unlisted platform? Clone the repository and run the Makefile target.

# requires a Go toolchain matching /.go-version git clone https://github.com/plexsphere/plexsphere.git cd plexsphere make plexctl-build # → bin/plexctl, stamped with build metadata
Full procedure — prerequisites, PATH setup, and shell completion — lives in the install guide.