quadletman
quadletman es una interfaz web basada en navegador para gestionar contenedores de Podman en servidores Linux sin root. Genera y administra archivos unitarios systemd, con aislamiento por usuario del sistema operativo, almacenamiento local y credenciales aisladas.
Ficha actualizada 23 sept 2026, 7:01 · upstream 23 sept 2026, 6:42 · release v0.5.5-beta
Qué es quadletman
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
quadletman es una aplicación web basada en el navegador que permite administrar contenedores de Podman en un servidor Linux sin necesidad de privilegios de administrador. En lugar de comunicarse directamente con la API socket de Podman, genera y gestiona archivos unitarios systemd nativos para cada servicio. Cada grupo de contenedores reside en un compartimento aislado: cuenta con su propio usuario del sistema operativo, almacenamiento de volúmenes dedicado, y una base de credenciales separada (secret o store de credenciales). El usuario accede a través de la interfaz web desde cualquier navegador, logueándose con sus credenciales del sistema operativo. La aplicación ofrece un ciclo de vida completo: creación de compartimentos, definición de contenedores y pods, gestión de volúmenes y secretos, programación de cronos, visualización de logs en tiempo real y monitoreo de uso de recursos.
La arquitectura se basa en generar archivos unitarios systemd que son interpretados por el sistema operativo para iniciar los servicios. Esto permite un aislamiento completo: cada servicio corre bajo su propio usuario del sistema con sus propias credenciales, volúmenes y políticas de seguridad. La aplicación funciona como una interfaz web sobre un servidor headless, eliminando la necesidad de interactuar directamente con la API socket de Podman.
El proyecto se construye en Python 3.12+ utilizando FastAPI como framework principal, junto con HTMX para la interacción del frontend y React para la gestión del estado de la aplicación. La arquitectura está diseñada para ser modular, escalable y fácil de mantener.
- Gestionar múltiples contenedores de desarrollo en un servidor Linux sin root
- Crear servicios persistentes con aislamiento por usuario del sistema operativo
- Monitoreo y control de recursos (CPU, RAM) de contenedores sin intervención manual
- Automatización de despliegues mediante cron jobs gestionados desde la interfaz web
- Gestión de volúmenes compartidos entre servicios con políticas de seguridad definidas
- Despliegue de aplicaciones en entornos headless sin necesidad de terminal o SSH
- Genera y administra archivos unitarios systemd nativos, permitiendo un aislamiento completo por usuario del sistema operativo.
- Interfaz web basada en navegador (HTMX) que permite gestionar contenedores desde cualquier dispositivo sin instalar software adicional.
- Credenciales de cada servicio se almacenan en el kernel o en memoria segura, evitando exponer credenciales a procesos del sistema.
- Soporta múltiples niveles de aislamiento: compartimentos con usuarios propios, volúmenes aislados y políticas de seguridad por contexto.
- Monitoreo en tiempo real de logs, uso de CPU y memoria sin necesidad de instalar herramientas adicionales.
- Diseño modular basado en FastAPI y React, facilitando la extensibilidad y el mantenimiento del proyecto.
- No es compatible con versiones anteriores de Podman (requiere Podman 4.4+).
- Funciona únicamente en Linux; no tiene soporte nativo para macOS o Windows.
- La interfaz web requiere un servidor web funcional y un navegador moderno para funcionar correctamente.
- El aislamiento por usuario del sistema operativo puede ser complejo de configurar en entornos con políticas de seguridad restrictivas.
- No incluye herramientas de despliegue completo (como Docker Compose) ni gestión de imágenes desde el lado del cliente.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar quadletman, se recomienda usar un reverse proxy como nginx o Caddy que sirva la aplicación en HTTPS. Se debe configurar una variable de entorno `QUADLETMAN_SECURE_COOKIES=true` para habilitar las pautas de seguridad del navegador. En entornos aislados, se puede utilizar un socket Unix (`QUADLETMAN_UNIX_SOCKET=/run/quadletman/quadletman.sock`) en lugar de una conexión TCP, lo que elimina la necesidad de abrir puertos en el servidor. Se recomienda ejecutar la aplicación como usuario `quadletman` con permisos adecuados y mantenerla activa mediante cron jobs o systemd timers para los servicios automatizados.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.