Skip to content

The Ownkube CLI

okctl drives Ownkube from your terminal.

  • Deploy from your shellokctl up ships the directory you are in
  • Logs and rollbackstail a deploy, put an earlier one back
  • JSON on every readadd -o json, script it in CI
brew install ownkube/tap/okctl
Install okctl Latest release macOS, Linux and Windows. amd64 and arm64.

Install okctl Homebrew, a binary or go install

  • Homebrew

    macOS and Linux. Shell completions come with it.

    brew install ownkube/tap/okctl
  • A binary

    macOS arm64 shown. Every OS and arch is on the latest release.

    curl -sSL https://github.com/ownkube/ownkube-cli/releases/latest/download/ownkube-cli_darwin_arm64.tar.gz \
      | tar -xz -C /usr/local/bin okctl
  • From source

    Needs a Go toolchain.

    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>
  • Machine-readable

    Add -o json to any read command.

  • Your own AWS account

    okctl aws connect links it. 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 okctl <command> --help for flags.

Deploy your first app in five minutes.

Push a repo and get a live URL, with no cloud account or config.

$5 of signup credit.