A modern, high-performance web dashboard for visualizing, auditing, and analyzing security scan results generated by the Trivy Operator across Kubernetes clusters.
- 🌐 Multi-Cluster Fleet Hub: Centralized cross-cluster security overview, global 30-day severity trends, cluster risk rankings, and directory cards.
- 🛡️ Comprehensive Trivy Operator Support: Automatically discovers all Trivy CRDs — Vulnerability, ConfigAudit, RBAC Assessment, Exposed Secrets, Infra Assessment, Compliance, and SBOM (including cluster-scoped variants).
- 📊 Executive & Engineering Views: Equal-height symmetrical layouts featuring 30-day vulnerability volume, scan breakdown matrices, and top vulnerable workloads.
- 🗂️ Modern UX & Navigation: Resizable sidebar (220px–480px) with persistent width, Aqua Security semantic iconography, and instant type search.
- 🔐 Authentication & Fine-Grained RBAC: File-backed local authentication (
auth.yaml) with user/group scopes, browser password manager integration, and anti-timing protections. - ⚡ High-Performance Architecture: Informer-based in-memory caching with disk snapshot persistence, sub-millisecond response times, and background polling sleep when tabs are inactive.
📸 Explore more screenshots: For reports list filtering, workload badges, and detail drawer inspection, see Dashboard Features & Navigation.
Run Trivy UI directly with Docker by mounting a directory containing your kubeconfig file(s):
docker run -d \
--name trivy-ui \
-v /path/to/kubeconfigs:/kubeconfigs \
-e KUBECONFIG_DIR=/kubeconfigs \
-p 8080:8080 \
locustbaby/trivy-ui:v0.0.5Open http://localhost:8080 in your browser. Every context in each mounted kubeconfig file is automatically discovered and initialized as a separate cluster.
Deploy to your Kubernetes cluster directly from Docker Hub's OCI registry:
helm upgrade --install trivy-ui oci://registry-1.docker.io/locustbaby/trivy-uiTo provide multiple cluster credentials via a Secret:
kubectl create secret generic kubeconfigs \
--from-file=prod=/path/to/prod-kubeconfig \
--from-file=staging=/path/to/staging-kubeconfig
helm upgrade --install trivy-ui oci://registry-1.docker.io/locustbaby/trivy-ui \
--set kubeconfigs.create=false \
--set kubeconfigs.secretName=kubeconfigsTrivy UI includes built-in file-backed authentication with fine-grained role-based access control (RBAC):
- Fine-Grained Scopes: Restrict users or teams to specific clusters, namespaces, or cluster-scoped audit reports.
- Native Login Experience: Seamless integration with browser password managers (Chrome, Safari, 1Password, Bitwarden), show/hide password toggle, and "Remember username".
- Hardened Security: Bcrypt password hashing, in-flight concurrency limiting, and anti-timing protections.
# auth.yaml example
version: v1
users:
admin:
passwordHash: "$2a$12$REPLACE_WITH_YOUR_BCRYPT_HASH"
scopes:
- cluster: "*"
namespaces: ["*", "_"] # All Namespaced and Cluster-scoped reports
developer:
passwordHash: "$2a$12$REPLACE_WITH_YOUR_BCRYPT_HASH"
scopes:
- cluster: "prod"
namespaces: ["team-a"] # Restricted to team-a in prod- 🔐 Password Hashing &
auth.yamlSyntax Guide — How to generate bcrypt hashes and structure user/group scopes. - 🐳 Docker Standalone Setup (
-e AUTH_MODE=local) — Mountauth.yamland pass session keys via Docker flags. - ☸️ Kubernetes / Helm Setup (
--set auth.mode=local) — Deploy using Kubernetes Secrets and Helm values.
Full operational, configuration, and developer guides are available in the User Guide:
| Guide | Focus |
|---|---|
| 📖 01. Installation & Configuration | Helm deployment, standalone Docker, ingress, cache tuning, and environment variables |
| 🔐 02. Authentication & Access Control | Password hashing, auth.yaml scopes, Web UI login experience, and API access |
| 🌐 03. Multi-Cluster Collection | Multi-cluster kubeconfig secrets, Fleet Hub cross-cluster overview, and cluster switching |
| 🛠️ 04. Operations & Troubleshooting | 401 Unauthorized troubleshooting, cluster permissions, and production health checks |
| 📊 05. Dashboard Features & Navigation | Resizable sidebar, Aqua semantic icons, 30-day trends, report filtering, and detail drawers |
| 🔌 06. API Reference & Error Codes | REST API endpoints, query filters, JSON error schema, and cURL examples |
| 📦 Helm Chart Reference | Complete list of Helm values and configurable deployment options |
trivy-ui/
├── go-server/ # High-performance Go backend with K8s client-go informers
├── trivy-dashboard/ # Modern React 19 + TypeScript + Vite + Tailwind CSS frontend
├── charts/ # Production-ready Helm chart
└── docs/ # Comprehensive user and architectural documentation
- Discovery: Backend dynamically discovers Trivy Operator CRDs and namespaces via the Kubernetes API.
- Streaming Watch: Kubernetes Informers establish persistent watches over discovered report types across all clusters.
- Optimized In-Memory Store:
SetTransformstrips large unused fields, keeping memory lean and queries sub-millisecond. - On-Demand Detail Fetch: Full report payloads and CVE remediations are loaded on demand and cached with a short TTL.
- Snapshot Persistence: Disk caching enables immediate warm startup on pod restarts without blocking on full cluster re-syncs.
sh start.shThis builds the frontend assets and launches the unified server at http://localhost:8080.
# Unit tests
cd go-server && go test ./...
# Frontend lint & build
cd trivy-dashboard && npm run lint && npm run buildThis project is licensed under the MIT License.


