Skip to content

Kubernetes under control, without complexity.

KubePeep is a local application to observe, investigate and operate Kubernetes with your existing kubeconfig and permissions, on desktop or in a local browser.

Download KubePeep Read the documentation
KubePeep Logo vetorial KubePeep com o hexágono interno uniformemente afastado da moldura externa.
terminal 
kubePeep# native desktop windowkubePeep serve# local web server on localhostkubePeep doctor# environment diagnostics

For Linux packages, the command is kubepeep.

Key features

Explore the latest stable features, as documented with the application.

Loading documentation for the latest stable release… View release on GitHub Original source: Portuguese (Brazil).

View feature details

How it works

A simple flow from kubeconfig to investigating a problem.

  1. Connect to your Kubernetes context

    KubePeep uses your existing kubeconfig and RBAC identity, without extra credentials.

  2. Choose context and default scope

    Select working namespaces. A manual list does not require permission to list all namespaces.

  3. Explore resources and events

    Open progressive lists and authorized details; logs and additional data load on demand.

  4. Investigate and act safely

    Use the problems view, resource relationships and backend-confirmed actions.

Who it’s for

For people who work with Kubernetes and want speed without sacrificing clarity.

  • Developers
  • DevOps
  • SREs
  • Platform engineers
  • Support teams
  • Users with limited cluster access
  • People who prefer a visual alternative to the terminal

Security and privacy

KubePeep operates within your existing permissions, without asking for extra credentials.

  • Uses your kubeconfig identity and Kubernetes RBAC, without impersonation.
  • Supports manual scopes without requiring global namespace discovery.
  • Runs locally, with the web server on localhost only.
  • Does not persist cluster resources, container logs or cursors to disk.
  • Check RBAC requirements and sensitive-data rules for the current release.
Read security and RBAC

Download KubePeep

Files come directly from the official KubePeep repository. This page detects your system and suggests a download, without proxies or tracking.

KubePeep

Loading release information…

Files download directly from the official KubePeep GitHub repository. When available, verify the file with the SHA-256 checksum file published with the release.

View all release files on GitHub

Installation options

  • Guided installer

    Installation scripts live in the source tree, not release attachments. Choose a published tag and review its script before running it.

    View installation instructions

  • Binary or compressed package

    Published packages include setup.exe for Windows x86_64, deb and rpm for Linux x86_64/ARM64, dmg for macOS Intel/Apple Silicon, plus CLI archives. Only files present in the selected release are offered here.

    Use the main download button or choose a file from the release list.

  • Build from source

    To build locally, see requirements and development instructions in the official documentation and repository.

    Requirements Development guide Repository

  • Docker and package managers Planned

    Additional installation methods are not yet officially available and will be announced when supported.

From installation to your first Pod

Install, choose your kubeconfig and context, set the namespace scope, and start using KubePeep.

  1. Install

    Download the latest package for your system, verify its checksum and install it. Then open KubePeep from your applications menu.

    Download KubePeep

  2. Choose your kubeconfig

    Use Add kubeconfig to select a file, paste its content or register a local path. Then choose the profile and context. Keep required credential plugins installed.

    Kubeconfig configuration

  3. Set your scope

    Save a default scope for the context: one namespace, a manual list, or all namespaces when RBAC permits. Manual names do not create namespaces or grant permissions.

    Namespaces

  4. Start investigating

    Open Overview, choose a workload or Pod, and inspect events and logs. Available actions follow your Kubernetes permissions.

    View documentation
Prefer the terminal?

Open web mode with an explicit kubeconfig, context and initial namespace. Replace the example path and names with your own.

kubePeep serve --kubeconfig "/path/to/config" --context "my-context" --namespace "my-namespace"

Linux system packages use kubepeep; CLI archives use kubePeep (kubePeep.exe on Windows).

The namespace flag selects an initial, temporary scope. Save the default scope in the interface for future sessions.

Check local and cluster connectivity:

kubePeep doctor

Read the latest release’s setup instructions

KubePeep releases

Stable releases and prereleases from the official repository. Information loads directly from GitHub when you open this page.

All releases

Contribute to KubePeep

KubePeep is built in public. Code, documentation, tests, ideas and reports all help it evolve.

Steps to contribute code

  1. Fork the project

    Fork the official repository to your GitHub account and clone it locally.

    Official repository

  2. Create a branch

    Use a descriptive branch from main, focused on one change.

    git checkout -b minha-contribuicao

  3. Set up development

    Follow the application repository’s development guide. For this site, use Node.js and npm as described in its README.

    make web-install

  4. Run checks

    Before opening an application pull request, run its repository checks. For this site, run lint, check, tests and build.

    make verify

  5. Open a pull request

    Describe why, what changed and how to test it. Pull requests pass CI before review.

    View pull requests

Contributions are welcome across the project:

  • Development
  • Interface and user experience
  • Documentation
  • Tests
  • Translations
  • Bug reports
  • Feature requests
  • Security
View issues Start a discussion View source code

Code of conduct

Issues, discussions, pull requests and community channels follow the KubePeep Code of Conduct. Treat everyone with respect.

Code of conduct Security advisories

About KubePeep

The story of KubePeep, its focus on simplicity and transparency, and the people behind it.

KubePeep is an open source project originally created by Franklin Moraes.

The official source code and project origin are available in the official KubePeep repository.

Motivation

Everyday Kubernetes tasks often mean switching between many commands and tools: seeing what runs, why a Pod failed or finding service logs.

KubePeep addresses this with a fast, minimal visual interface that respects your existing kubeconfig, context and permissions.

The problem we address

Investigating clusters should not require memorizing commands. KubePeep brings workloads, events, logs and Pod operations together, reducing complexity while respecting Kubernetes permissions.

Philosophy

  • Simplicity: only the essentials, without bloated dashboards.
  • Transparency: open development and documented decisions.
  • Secure by default: show only what your identity can read and enable only authorized actions.
  • Privacy: local operation, without sending cluster data to external services.

Open source at heart

Explore KubePeep, suggest improvements, report issues and contribute. Development is public, guided by the community and documented decisions.

  • Open source
  • Free
  • Transparent
  • Community driven
  • For developers, platform teams, DevOps and SRE

License

KubePeep and this site are distributed under Apache License 2.0. The site includes a NOTICE preserving authorship notices. Details on the License.

Original maintainer

Franklin Moraes — original creator and maintainer of KubePeep.

Visit the repository GitHub profile

Enjoy KubePeep? Support development.

KubePeep is maintained as open source. Your support helps maintenance, documentation, tests and new features.

Buy me a coffee