Skip to content
A web-based, highly extensible platform for developers to better understand the complexity of Kubernetes clusters.
Go TypeScript HTML CSS JavaScript Shell Other
Branch: master
Clone or download
Latest commit 31400b3 Oct 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Disable CircleCI docker layer caching Oct 11, 2019
changelogs Bump makefile and add changelog Oct 15, 2019
choco Update choco version, sha, and vmware org references Oct 15, 2019
cmd move to using DCO for Octant Oct 8, 2019
docs [docs] fix path plugin/ -> plugins/ Oct 11, 2019
examples move to using DCO for Octant Oct 8, 2019
hacks rename clustereye => octant Jun 19, 2019
internal reduce content refresh delay to 1s Oct 14, 2019
pkg add namespace printer and navigation to cluster overview Oct 12, 2019
thirdparty/unstructured vendor a unstructured converter than can handle int64 => float64 Aug 9, 2019
tools Added go tools and build env vars; remove unused choco files Jul 11, 2019
vendor Added tests and changelog Sep 26, 2019
web Merge pull request #338 from nfarruggiagl/dark-theme-and-theme-switch… Oct 15, 2019
.dockerignore Move namespaces which are overview specific to top level Sep 19, 2019
.drone.yml add drone nightly build Oct 15, 2019
.gitattributes CI build using choco on Windows Dec 5, 2018
.gitignore Create applications module Sep 23, 2019
.gitmodules Plugin docs served using Hugo Jun 13, 2019
.golangci.yml Create plugin helper service Jul 12, 2019
.goreleaser-nightly.yml add drone nightly build Oct 15, 2019
.goreleaser.yml Change email from octant-dashboard to project-octant Aug 6, 2019
.nvmrc Upgrade to Angular 8 and Clarity 2.2 (#286) Sep 20, 2019 Bump makefile and add changelog Oct 15, 2019 move to using DCO for Octant Oct 8, 2019
Dockerfile move to using DCO for Octant Oct 8, 2019
Dockerfile.plugin move to using DCO for Octant Oct 8, 2019 allow usage of reverse proxy for frontend Sep 23, 2019
LICENSE Fix LICENSE so tools parse it correctly Aug 23, 2019
Makefile Bump makefile and add changelog Oct 15, 2019
NOTICE move to using DCO for Octant Oct 8, 2019 fix link/badge in readme Oct 15, 2019 add roadmap Jul 19, 2019
doc.go dev dash => octant Jun 19, 2019
go.mod Added tests and changelog Sep 26, 2019
go.sum upgrade opencensus to 0.22.1 Sep 20, 2019


Build Status GitHub release License

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.


  • Resource Viewer

    Graphically visualizate relationships between objects in a Kubernetes cluster. The status of individual objects are represented by color to show workload performance.

  • Summary View

    Consolidated status and configuration information in a single page aggregated from output typically found using multiple kubectl commands.

  • Port Forward

    Forward a local port to a running pod with a single button for debugging applications and even port forward multiple pods across namespaces.

  • Log Stream

    View log streams of pod and container activity for troubleshooting or monitoring without holding multiple terminals open.

  • Label Filter

    Organize workloads with label filtering for inspecting clusters with a high volume of objects in a namespace.

  • Cluster Navigation

    Easily change between namespaces or contexts across different clusters. Multiple kubeconfig files are also supported.

  • Plugin System

    Highly extensible plugin system for users to provide additional functionality through gRPC. Plugin authors can add components on top of existing views.


Octant demo


Package (Linux only)

  1. Download the .deb or .rpm from the releases page.

  2. Install with either dpkg -i or rpm -i respectively.



  1. Install using chocolatey with the following one-liner:

    choco install octant --confirm


  1. Add the extras bucket.

    scoop bucket add extras
  2. Install using scoop.

scoop install octant



  1. Install using Homebrew with the following one-liner:

    brew install octant

Download a Pre-built Binary (Linux, macOS, Windows)

  1. Open the releases page from a browser and download the latest tarball or zip file.

  2. Extract the tarball or zip where X.Y is the release version:

    $ tar -xzvf ~/Downloads/octant_0.X.Y_Linux-64bit.tar.gz
  3. Verify it runs:

    $ ./octant_0.X.Y_Linux-64bit/octant version

Getting Started

Before starting Octant, make sure you have access to a healthy cluster. If kubectl is installed, test using kubectl cluster-info.

Start running Octant:

$ octant

Octant should immediately launch your default web browser on

Or to run it on a specific host and fixed port: $ OCTANT_LISTENER_ADDR= octant

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 make install-test-plugin.

Documentation for plugin components can be found in docs/plugins.


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

You can’t perform that action at this time.