A web-based, highly extensible platform for developers to better understand the complexity of Kubernetes clusters.
Octant is a tool for developers to understand how applications run on a Kubernetes cluster. It aims to be part of the developer's toolkit for gaining insight and approaching complexity found in Kubernetes. Octant offers a combination of introspective tooling, cluster navigation, and object management along with a plugin system to further extend its capabilities.
Graphically visualizate relationships between objects in a Kubernetes cluster. The status of individual objects are represented by color to show workload performance.
Consolidated status and configuration information in a single page aggregated from output typically found using multiple kubectl commands.
Forward a local port to a running pod with a single button for debugging applications and even port forward multiple pods across namespaces.
View log streams of pod and container activity for troubleshooting or monitoring without holding multiple terminals open.
Organize workloads with label filtering for inspecting clusters with a high volume of objects in a namespace.
Easily change between namespaces or contexts across different clusters. Multiple kubeconfig files are also supported.
Highly extensible plugin system for users to provide additional functionality through gRPC. Plugin authors can add components on top of existing views.
.rpm from the releases page.
Install with either
dpkg -i or
rpm -i respectively.
Install using chocolatey with the following one-liner:
choco install octant --confirm
Add the extras bucket.
scoop bucket add extras
Install using scoop.
scoop install octant
Install using Homebrew with the following one-liner:
brew install octant
Open the releases page from a browser and download the latest tarball or zip file.
Extract the tarball or zip where
X.Y is the release version:
$ tar -xzvf ~/Downloads/octant_0.X.Y_Linux-64bit.tar.gz octant_0.X.Y_Linux-64bit/README.md octant_0.X.Y_Linux-64bit/octant
Verify it runs:
$ ./octant_0.X.Y_Linux-64bit/octant version Version: 0.X.Y Git commit: e37e7f6c6c797ef215fdbeedb91c709c88193522 Built: 2019-10-15T01:24:21Z
Before starting Octant, make sure you have access to a healthy cluster. If kubectl is installed, test using
Start running Octant:
Octant should immediately launch your default web browser on
Or to run it on a specific host and fixed port:
For configuring Octant, setting up a development environment, or running tests, refer to the documentation here.
Plugins are a core part of Octant in the Kubernetes ecosystem. A plugin can read objects and allows users to add components to Octant's views.
An example plugin can be found in
cmd/octant-sample-plugin and installed to the default plugin path with
go run build.go install-test-plugin.
Documentation for plugin components can be found in
Feature requests, bug reports, and enhancements are welcome. Contributors, maintainers, and users are encouraged to collaborate through these communication channels:
New contributors will need to sign a CLA (contributor license agreement). We also ask that a changelog entry is included with your pull request. Details are described in our contributing documentation.
See our hacking guide for getting your development environment setup.
See our roadmap for tentative features in a 1.0 release.
Octant is available under the Apache License, Version 2.0