Cloud Native 5 min read

Master Kubernetes Management with Kuboard: Visual UI Guide & Installation

Kuboard is a web‑based visual tool for managing Kubernetes clusters, offering multi‑auth, multi‑cluster support, micro‑service layering, and storage integration; the guide explains Docker installation, adding clusters via KubeConfig, workload inspection, and how the UI simplifies complex command‑line operations.

Efficient Ops
Efficient Ops
Efficient Ops
Master Kubernetes Management with Kuboard: Visual UI Guide & Installation

What is Kuboard

Kuboard is a web‑based UI for managing and monitoring Kubernetes clusters, offering an intuitive interface to view and operate resources.

Kuboard architecture
Kuboard architecture

Key Features

Multiple authentication methods: built‑in user store, GitLab/GitHub SSO, LDAP.

Multi‑cluster management: import several clusters, assign namespace permissions to users or groups.

Micro‑service layered view: workloads are displayed in classic micro‑service layers.

Storage support: integrates NFS, CephFS, supports volume expansion and snapshots.

Rich interoperability: provides CLI‑like operations through the UI.

Installation

Kuboard is recommended to be deployed via Docker:

<code>docker run -d \
  --restart=unless-stopped \
  --name=kuboard \
  -p 80:80/tcp \
  -p 10081:10081/tcp \
  -e KUBOARD_ENDPOINT="http://<YOUR_SERVER_IP>:80" \
  -e KUBOARD_AGENT_SERVER_TCP_PORT="10081" \
  -v /root/kuboard-data:/data \
  eipwork/kuboard:v3
</code>

After starting the container, open a browser at the server address to access the Kuboard v3.x interface.

Kuboard login page
Kuboard login page

Kuboard does not need to be on the same network segment as the K8s cluster.

It is recommended to use a domain name for the KUBOARD_AGENT.

The domain must be resolvable via DNS.

Adding a Kubernetes Cluster

3.1 Connect via KubeConfig

1. Obtain the KubeConfig file (default location

~/.kube/config

).

<code># From the cluster admin or generate it
cat ~/.kube/config
</code>

2. In Kuboard, go to “Cluster Management → Add Cluster”, choose the KubeConfig method, paste or upload the file, and specify a cluster name (e.g., prod‑cluster).

Viewing Workloads

Kuboard aggregates Deployment history, Pod lists, related events, and container details on a single page, helping users quickly diagnose issues and perform operations.

Workload view
Workload view

Conclusion

Using Kuboard eliminates the complexity of command‑line tools, providing a visual interface that makes Kubernetes cluster management more intuitive.

cloud nativeDockerKubernetesCluster ManagementKuboard
Efficient Ops
Written by

Efficient Ops

This public account is maintained by Xiaotianguo and friends, regularly publishing widely-read original technical articles. We focus on operations transformation and accompany you throughout your operations career, growing together happily.

0 followers
Reader feedback

How this landed with the community

login Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.