RackPeek: Documenta y visualiza tu rack del homelab
Qué cubre este artículo
- Qué es RackPeek: herramienta open source para documentación y visualización de racks.
- Cuándo vale la pena usarla (y cuándo no).
- Instalación y flujo de trabajo típico.
- Alternativas y su lugar en el conjunto de herramientas del homelab.
Introducción
Cuando un homelab supera los tres dispositivos, el caos empieza: ¿a dónde va cada cable? ¿Qué está conectado en el puerto 5? ¿Qué unidad de altura ocupa el switch? RackPeek es una herramienta open source ligera que resuelve exactamente esto: un plano visual de tu rack o armario. Arrastra dispositivos, documenta puertos, registra las conexiones de cables.
Es el gemelo digital del concepto para tu homelab: antes de tocar algo físicamente, consultas RackPeek para saber qué encontrarás dónde.
Escenarios de uso típicos
- Planificar el diseño del rack: Antes de recibir hardware, planifica unidades de altura (U) y peso.
- Documentar cableado: Registra qué puerto va a dónde, invaluable en troubleshooting.
- Inventario: Todos los dispositivos, números de serie, IPs y MACs en un solo lugar.
- Preparar reorganizaciones: Visualiza antes y después, estima longitudes de cables.
- Documentación compartida: Cuando varias personas trabajan en el mismo homelab (familia, asociación, empresa).
Instalación
RackPeek se ejecuta como una aplicación web. La instalación más simple es con Docker, o puedes probar la demo alojada:
services:
rackpeek:
image: ghcr.io/rackpeek/rackpeek:latest # Verifica los nombres de imagen en la documentación del repo
ports: ["127.0.0.1:8282:80"]
volumes: [rackpeek_data:/data]
restart: always
volumes:
rackpeek_data:
También puedes usarlo como una aplicación estática en el navegador: los datos se mantienen locales (localStorage o exportación de archivos), sin servidor necesario para empezar.
Flujo de trabajo
- Crear un rack: Define las unidades de altura, por ejemplo 12U para un mini rack.
- Agregar dispositivos: Especifica el tipo (servidor, switch, SAI, patchpanel), altura, nombre, fabricante.
- Posicionar mediante arrastre: Coloca los dispositivos en sus posiciones de U, viendo la disposición como en un rack real.
- Puertos y conexiones: Documenta los cables de puerto a puerto.
- Notas e IPs: Añade interfaces de gestión, números de serie, MACs.
Cuándo vale la pena y cuándo no
Vale la pena:
- A partir de ~3 dispositivos en el rack; menos que eso, no lo necesitas.
- Si haces reorganizaciones frecuentes o cambias dispositivos.
- Con varias personas compartiendo el mismo setup.
No es necesario en:
- Setups de un solo dispositivo (una mini PC aislada no necesita gestión de rack).
- Si ya mantienes un wiki o inventario (NetBox es la alternativa más completa).
Alternativas
| Herramienta | Fortaleza | Debilidad |
|---|---|---|
| RackPeek | Ligera, visual, sencilla | Menos features que herramientas DCIM |
| NetBox | El estándar DCIM, muy potente | Significativamente más compleja, requiere Postgres |
| Homarr/Dashy | Dashboard con enlaces a servicios | No visualiza diseño de rack físico |
| Wiki (ej. Wiki.js) | Documentación libre | Sin visualización del rack |
Posición en el ecosistema
RackPeek no es imprescindible, pero la primera vez que busques “ese cable rojo” o necesites encontrar una unidad libre, un rack documentado es una bendición. Combinado con el Homelab-Guide, el flujo es: construye la infraestructura física → documéntala en RackPeek → opera con Monitoring.
Enlaces relacionados
- IRC-Coding.de: Tutoriales de programación.
- Homelab-Guide: El lado del hardware.
- Monitoring: Supervisa tu lab en producción.
- Docker: Conceptos básicos de deployment.
- Backup: Protege la configuración.
Puntos clave:
- RackPeek = documentación visual del rack: dispositivos, posiciones de U, cables, IPs.
- Vale la pena a partir de ~3 dispositivos o si haces reorganizaciones frecuentes.
- Ligera, no es un monstruo DCIM como NetBox, pero perfecta para homelabs.
- Úsala como aplicación estática (local) o auto-alojada con Docker.
- Combinación con Homelab-Guide: construye → documenta → monitorea.
Preguntas frecuentes
¿Qué es RackPeek?
¿Cuándo vale la pena?
¿RackPeek o NetBox?
¿Dónde se guardan los datos?
¿Es gratuito?
Fuentes y referencias
- RackPeek: GitHub.
- IRC-Coding.de: Tutoriales de programación.


