homelab/homarr/README.md

Homarr

Dashboard with Kubernetes integration and persistent application state.

Kubernetes uses the homarr ServiceAccount and the read-only ClusterRole in k8s/rbac.yaml. Application data lives in homarr-pvc; supply the encryption key from k8s/secrets.yaml.example before the first start and retain it with backups.

The committed ingress is internal. There is no k8s/active marker even though manifests exist, so the workflow does not select Homarr automatically.

Compose publishes ports 80 and 81, mounts appdata and the Docker socket, and expects a local kubeconfig. Check these host ports against Traefik before use.

Inspect

From the repository root:

kubectl get pods,svc,pvc -n homarr
kubectl get events -n homarr --sort-by=.metadata.creationTimestamp

See the repository README for deployment selection.