// 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 and CI-friendly, and every read command speaks JSON.

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

Ship your first app in the next five minutes.

Push a repo, get a live URL on Ownkube Compute. No cloud account, no config, no card. Move to your own AWS the day you need to.

No cloud account needed. Live in 5 minutes from your browser.