xavor/cockpit-kvm repository overview

⁠🖥️ xavor/cockpit-kvm

Contenedor Docker para ejecutar Cockpit con soporte para KVM y libvirt, pensado para integrarse en entornos como Kubernetes, Proxmox, o cualquier sistema que requiera una interfaz de administración web ligera y potente.

⁠🚀 Características

• 🔧 Basado en Debian Bookworm
• 🔐 Autenticación configurable (usuario + contraseña)
• 🖥️ Incluye cockpit-machines, libvirt-clients, sudo
• 📦 Ligero y listo para producción
• 🧱 Compatible con Kubernetes / K3s (con hostPath para /dev/kvm y /var/run/libvirt)

⁠🧪 Variables de entorno

⁠🔐 Ejemplo de uso con Docker

docker run -d \
  --name cockpit \
  -p 9090:9090 \
  -e COCKPIT_USER=admin \
  -e COCKPIT_PASSWORD=secreta \
  --device /dev/kvm \
  -v /var/run/libvirt:/var/run/libvirt \
  xavor/cockpit-kvm:latest

⁠☸️ Uso en Kubernetes (ejemplo)

env:
  - name: COCKPIT_USER
    valueFrom:
      secretKeyRef:
        name: cockpit-secret
        key: username
  - name: COCKPIT_PASSWORD
    valueFrom:
      secretKeyRef:
        name: cockpit-secret
        key: password

Con volumenes hostPath para:

• /dev/kvm → acceso al hipervisor
• /var/run/libvirt → socket de libvirt

⁠🔑 Acceso

Una vez levantado, accede a:

http://<IP_DEL_HOST>:9090

⁠📁 Archivos incluidos

• Dockerfile
• entrypoint.sh

⁠🛠️ Requisitos del host

• Tener libvirtd corriendo
• El contenedor necesita acceso a /dev/kvm y /var/run/libvirt