Terminal and Web console for Kubernetes
- Configuration from kubeconfig files (
KUBECONFIGenvironment variable or
- Switch contexts interactively
- Authentication support (bearer token, basic auth, private key / cert, OAuth, OpenID Connect, Amazon EKS, Google Kubernetes Engine, Digital Ocean)
- Namespace selection and pods list watching
- Container log scrolling / watching
- Container resources usage (memory, CPU, network, file system charts) 
- Container remote exec terminal
- Cluster, namespace, pod events
Follow @kubebox for some updates.
The following alternatives are available for you to use Kubebox, depending on your preferences and constraints:
Download the Kubebox standalone executable for your OS:
# Linux $ curl -Lo kubebox https://github.com/astefanutti/kubebox/releases/download/v0.8.0/kubebox-linux && chmod +x kubebox # OSX $ curl -Lo kubebox https://github.com/astefanutti/kubebox/releases/download/v0.8.0/kubebox-macos && chmod +x kubebox # Windows $ curl -Lo kubebox.exe https://github.com/astefanutti/kubebox/releases/download/v0.8.0/kubebox-windows.exe
Kubebox can be served from a service hosted in your Kubernetes cluster. Terminal emulation is provided by Xterm.js and the communication with the Kubernetes master API is proxied by the server.
To deploy the server in your Kubernetes cluster, run:
$ kubectl apply -f https://raw.github.com/astefanutti/kubebox/master/kubernetes.yaml
To shut down the server and clean-up resources, run:
$ kubectl delete namespace kubebox
For the Ingress resource to work, the cluster must have an Ingress controller running. See Ingress controllers for more information.
Alternatively, to deploy the server in your OpenShift cluster, run:
$ oc new-app -f https://raw.github.com/astefanutti/kubebox/master/openshift.yaml
You can run Kubebox as an in-cluster client with
$ kubectl run kubebox -it --rm --env="TERM=xterm" --image=astefanutti/kubebox --restart=Never
If RBAC is enabled, you’ll have to use the
--serviceaccountoption and reference a service account with sufficient permissions.
You can run Kubebox using Docker, e.g.:
$ docker run -it --rm astefanutti/kubebox
You may want to mount your home directory so that Kubebox can rely on the
$ docker run -it --rm -v ~/.kube/:/home/node/.kube/:ro astefanutti/kubebox
We try to support the various authentication strategies supported by
kubectl, in order to provide seamless integration with your local setup. Here are the different authentication strategies we support, depending on how you’re using Kubebox:
|Google Kubernetes Engine||yes|
If the mode you’re using isn’t supported, you can refresh the authentication token/certs manually and update your kubeconfig file accordingly.
Kubebox relies on cAdvisor to retrieve the resource usage metrics. Before version 0.8.0, Kubebox used to access the cAdvisor endpoints, that are embedded in the Kubelet. However, these endpoints are being deprecated, and will eventually be removed, as discussed in kubernetes#68522.
Starting version 0.8.0, Kubebox expects cAdvisor to be deployed as a DaemonSet. This can be achieved with:
$ kubectl apply -f https://raw.github.com/astefanutti/kubebox/master/cadvisor.yaml
It’s recommended to use the provided
cadvisor.yamlfile, that’s tested to work with Kubebox. However, the DaemonSet example, from the cAdvisor project, should also work just fine. Note that the cAdvisor containers must run with a privileged security context, so that they can access the container runtime on each node.
You can change the default
--housekeeping_intervaloptions, added to the cAdvisor container arguments declared in the
cadvisor.yamlfile, to adjust the duration of the storage moving window (default to
5m0s), and the sampling period (default to
10s) respectively. You may also have to provide the path of your cluster container runtime socket, in case it’s not following the usual convention.
|n||Change current namespace|
[Alt+]1, …, 9
(use Shift or Alt inside exec terminal)
|↑, ↓||Navigate list / form / log|
|Enter||Select item / submit form|
|Esc||Close modal window / cancel form / rewind focus|
|Ctrl+z||Close current tab|
|q, Ctrl+q||Exit |
|←, →||Navigate Kube configurations|
|Enter||Select pod / cycle containers|
|r||Remote shell into container|
|f||File system usage|
|e||Open pod events tab|
|Shift+e||Open namespace events tab|
|Ctrl+e||Open cluster events tab|
|g, Shift+g||Move to top / bottom|
|Ctrl+u, Ctrl+d||Move one page up / down|
- Resources usage metrics are unavailable!
- Starting version 0.8.0, Kubebox expects cAdvisor to be deployed as a DaemonSet. See the cAdvisor section for more details;
- The metrics are retrieved from the REST API, of the cAdvisor pod running on the same node as the container for which the metrics are being requested. That REST API is accessed via the API server proxy, which requires proper RBAC permission, e.g.:
# Permission to list the cAdvisor pods (selected using the `spec.nodeName` field selector) $ kubectl auth can-i list pods -n cadvisor yes # Permission to proxy the selected cAdvisor pod, to call its REST API $ kubectl auth can-i get pod --subresource proxy -n cadvisor yes
$ git clone https://github.com/astefanutti/kubebox.git $ cd kubebox $ npm install $ node index.js
2. Custom IDP certificate authority files are not supported in Web versions.
3. Not available in Web versions.