Kubernetes

Containers

Kubernetes is a powerful container orchestration platform that automates the deployment, scaling, and management of containerized applications.

Homarr provides a read-only view of pods, services, ingresses, nodes, ConfigMaps, Secrets, namespaces, and volumes. Metrics Server is optional; without it, inventory and reserved capacity remain available but live CPU and memory do not.

In-cluster access

Enable RBAC in the Homarr Helm values:

rbac:
  enabled: true

The chart creates the service account and read-only Role/ClusterRole bindings used by Homarr. Kubernetes 1.24 or newer is required.

Kubeconfig contexts

When Homarr runs outside the cluster, mount a kubeconfig read-only and set KUBECONFIG to its in-container path:

services:
  homarr:
    volumes:
      - ./kubeconfig:/app/config/kubeconfig:ro
    environment:
      KUBECONFIG: /app/config/kubeconfig

The management page exposes every configured context. An unavailable context does not hide healthy contexts; a context without Metrics Server is marked Metrics unavailable.

Kubernetes resources are not converted into Homarr apps or integrations during Docker discovery.