Skip to content

Getting started

Requirements

kop requires Python 3.9 or later. For a better experience, recommend using the latest Python version. kop runs on Linux, macOS, Windows and probably any OS where Python also runs.

Your platform

Linux (all distros)

All Linux distros come with a terminal emulator that can run kop.

If you are using the Linux console (rather than a desktop environment), see font-for-textual for details.

macOS

The default terminal app is limited to 256 colors. We recommend installing a newer terminal such as iterm2, Ghostty, Kitty, or WezTerm.

Windows

The new Windows Terminal runs kop beautifully.

Installation

Here's how to install kop.

You can install kop via PyPI, with the following command:

pip install kop-cli

After installation, you can run:

kop --version

Usage

1. Startup

kop

By default, it will load:

  • ~/.kube/config (if it exists)
  • kubeconfig files already synced under ~/.kop/

If no available cluster is found, you can import configuration from the startup page via Add or Sync.

2. Start with a Specified kubeconfig

kop --kubeconfig /path/to/kubeconfig.yaml

In this mode, the file path and kubeconfig validity are verified, and after validation it enters the resource view directly.