ork upgrade

1 min read

Upgrade the Orkestra CLI to the latest release or to a specific version.

ork upgrade [flags]

This command downloads the appropriate release artifacts for your OS/architecture, installs the updated ork binary, and optionally installs the orkcc Control Center binary.

Flags

FlagDescription
--version <tag>Upgrade to a specific version (e.g., v1.4.0)
--runtime-onlyUpgrade only the ork CLI (skip installing orkcc)
--checkCheck whether a newer version is available

Usage

Upgrade to the latest version:

ork upgrade

Upgrade to a specific version:

ork upgrade --version v1.4.0

Upgrade only the runtime binary:

ork upgrade --runtime-only

Check for updates without installing:

ork upgrade --check

Behavior

  • Detects the current platform (linux_amd64, linux_arm64, darwin_amd64, darwin_arm64).
  • Resolves the target version:
    • uses --version if provided
    • otherwise fetches the latest release from GitHub
  • Downloads the corresponding tar.gz archive for:
    • ork
    • orkcc (unless --runtime-only is used)
  • Extracts the binary from the archive.
  • Installs it to:
/usr/local/bin/
  • Prints the installed version after completion.

Upgrade Check

ork upgrade --check

Displays:

  • current installed version
  • latest available version
  • whether an upgrade is available

Notes

  • If a binary is not available for the current platform, it is skipped.
  • Installation may require elevated permissions depending on the system.
  • The upgrade process replaces the existing binaries in /usr/local/bin.