// command_line

The Ownkube CLI

okctl drives Ownkube from your terminal. Connect an AWS account, ship deployments, tail logs, and pull connection details without leaving your shell. It is scriptable, agent-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

bash

# Log in via your browser
okctl login

# Connect an AWS account (opens the console to deploy a scoped role)
okctl aws connect

# Inspect and operate your deployments
okctl deploy list --cluster <cluster-id>
okctl deploy logs <deployment-id>

Add -o json to any read command for machine-readable output. Prefer autonomous onboarding? okctl aws connect --deploy creates the CloudFormation stack for you using the AWS credentials already in your shell. Ownkube never receives your AWS keys.

Common commands

okctl login Browser-based sign in and credential management

okctl aws connect Connect an AWS account and manage its access

okctl clusters list Inspect your clusters

okctl deploy list Inspect deployments, status, and revisions

okctl deploy logs Tail logs from a deployment

okctl deploy connection Get in-cluster connection details

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

// get_started

You shouldn't have to trade velocity for control.

Connect your AWS account in minutes. Push code, get a preview URL, and let the agents take ops off your plate.

Connect your cloud Talk to us

Free tier on AWS. Setup in 5 minutes from your browser.