The Ownkube CLI

okctl drives Ownkube from your terminal. Deploy the directory you are in, tail logs, roll back, and check your wallet without leaving your shell. It is scriptable and CI-friendly, and every read command speaks JSON.

Install okctl Latest release ↗

macOS, Linux, and Windows. amd64 and arm64.

Homebrew (macOS and Linux)

brew install ownkube/tap/okctl

Shell completions are wired up automatically.

Pre-built binaries

# macOS arm64 example
curl -sSL https://github.com/ownkube/ownkube-cli/releases/latest/download/ownkube-cli_darwin_arm64.tar.gz \
  | tar -xz -C /usr/local/bin okctl

Grab a tarball for your OS and arch from the latest release.

From source

go install github.com/ownkube/okctl@latest

Quick start

Terminal

# Log in via your browser
okctl login

# Point this directory at a deployment, then build and ship it
okctl link
okctl up

# Watch it run
okctl deploy logs <deployment-id>

Add -o json to any read command for machine-readable output. If you run in your own AWS account, okctl aws connect links it and the same commands work after that.

Common commands

okctl login Sign in through your browser

okctl up Build and deploy the current directory

okctl link Link this directory to a deployment

okctl regions list List the regions you can deploy to

okctl deploy status Check health and whether the URL is live

okctl deploy logs Tail logs from a deployment

okctl deploy rollback Roll back to an earlier revision

okctl usage month-to-date See what this month has drawn from your wallet

okctl billing wallet Check your wallet balance

Full command reference lives in the CLI docs. Run okctl <command> --help for flags and arguments.