Proyecto

TouchRack

Linux TTY Touch Homelab

Consola táctil multi-nodo para homelab diseñada específicamente para pantallas físicas conectadas a una TTY de Linux, sin necesidad de X11, Wayland, navegador ni entorno de escritorio.

01 / Resumen

Una consola física para el homelab

TouchRack convierte una pequeña pantalla táctil conectada directamente a un sistema Linux en una consola de monitorización dedicada. La interfaz está diseñada alrededor de las restricciones de una consola física y permite supervisar tanto el host local como múltiples nodos Linux remotos desde un único punto de acceso táctil.

02 / Capacidades

Capacidades

01
Local SSH Agentless

Multi-node

Un mismo panel permite seleccionar y supervisar el host local y nodos Linux remotos. Los nodos remotos no necesitan ejecutar un agente TouchRack y se consultan mediante un transporte SSH restringido.

02
Host Storage Containers

System monitoring

CPU, memoria, almacenamiento, temperatura, salud de discos y contenedores se presentan mediante vistas adaptadas al espacio disponible en la consola física.

03
CRUX systemd HTTP TCP

Services

Los servicios importantes se definen de forma explícita y se normalizan en estados comunes independientemente de si proceden de CRUX, systemd, contenedores, HTTP o TCP.

04
evdev Linux console Wake guard

Physical touch

La entrada táctil se lee directamente desde evdev. El control de suspensión de pantalla incluye una protección de despertar para que el primer toque reactive el panel sin ejecutar accidentalmente la acción situada bajo el dedo.

03 / Media

TouchRack en uso

La interfaz está diseñada para una pantalla táctil física y una consola Linux compacta, no como una aplicación de escritorio adaptada posteriormente.

04 / Arquitectura

Arquitectura

TouchRack separa la presentación de la obtención de datos para que la interfaz no necesite conocer cómo se monitoriza cada recurso.

Textual UI

La interfaz está construida con Textual y dispone de un layout compacto específico para terminales pequeños como la consola física de referencia de 64×18 celdas.

Node runtime

Cada nodo se representa mediante una identidad, runtime y transporte comunes sobre los que trabajan las distintas capacidades de monitorización.

Providers

Host, almacenamiento, SMART, contenedores y servicios utilizan providers independientes que transforman distintas fuentes de información en modelos consumibles por la interfaz.

Local / SSH transport

El mismo modelo permite consultar el sistema local o ejecutar comandos de lectura definidos sobre nodos remotos mediante OpenSSH.

Resilient state

Los fallos de transporte conservan la última información válida como STALE y un circuit breaker compartido evita conexiones SSH redundantes mientras un nodo permanece inaccesible.

Read-only by design

TouchRack está diseñado como superficie de observación. Los fallos de monitorización degradan el estado mostrado en lugar de convertir la consola en una interfaz de administración con privilegios generales.

05 / Despliegue

Despliegue

systemd openvt Linux VC

Dedicated TTY runtime

El despliegue de referencia ejecuta TouchRack como servicio systemd sobre una TTY dedicada mediante openvt. El runtime se instala de forma independiente en /opt/touchrack y mantiene su configuración bajo /etc/touchrack.

06 / Enlaces

Enlaces