ServerClaw
Plataforma IaaC para transformar un servidor Debian 13 en entorno Proxmox VE con 70+ servicios auto-hospedados, gestionada desde un único repositorio Git con soporte nativo para asistentes de IA.
Ficha actualizada 24 sept 2026, 8:35 · upstream 24 sept 2026, 8:18 · release sin release detectada
Qué es ServerClaw
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ServerClaw es una plataforma de infraestructura como código diseñada para automatizar el despliegue completo de entornos auto-hospedados sobre Debian 13 y Proxmox VE. El repositorio contiene todo lo necesario: 516+ ADRs documentando decisiones arquitectónicas, 274+ runbooks paso a paso, 162 roles Ansible y 60 playbooks para gestionar la infraestructura de forma declarativa.
La plataforma está construida con enfoque AI-native, optimizada para que asistentes de programación como Claude Code puedan entender, desplegar y extender cada servicio. Utiliza un modelo de identidad aislada donde todos los valores del operador residen en un único archivo (identity.yml), evitando hardcodeo de dominios o hostnames en el código de roles.
La arquitectura define múltiples VMs gestionadas declarativamente: nginx-edge como proxy inverso, docker-runtime para aplicaciones, postgres para bases de datos compartidas, backup para Proxmox Backup Server, y runtime-ai para cargas GPU. El inventario se genera automáticamente desde platform-host.yml sin edición manual de IPs.
- Despliegue completo de plataforma self-hosted con 70+ servicios en servidor Debian 13
- Gestión declarativa de VMs Proxmox VE mediante Ansible y templates Jinja2
- Orquestación de servicios AI/LLM locales (Ollama, Dify, LiteLLM, LibreChat)
- Implementación de control plane con lanes separados para command, api, message y event
- Automatización de operaciones mediante runbooks ejecutables por agentes de IA
- 516+ ADRs documentando cada decisión arquitectónica e indexadas para búsqueda
- 274+ runbooks paso a paso que pueden seguirse automáticamente por agentes de IA
- Sistema de identidad aislada: único archivo identity.yml controla toda la rebranding
- Inventario generado automáticamente desde platform-host.yml sin edición manual
- Soporte para múltiples perfiles de proveedor (cloud, Debian genérico, homelab)
- Gates de verificación integrados en Makefile para validar cada etapa del bootstrap
- No utiliza Docker ni Compose en producción (solo en entorno docker-dev local)
- Requiere edición manual de inventory/group_vars/all/identity.yml para rebranding
- Complejidad media: requiere 4 núcleos CPU y 8 GB RAM mínimo para desarrollo
- Dependencia de Proxmox VE como hypervisor principal para despliegue completo
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.
Recomendado para equipos con 4+ núcleos CPU y 8+ GB RAM. Iniciar con make init-local para generar secretos, luego make generate-inventory antes de editar identity.yml. Para desarrollo local usar make docker-dev-up (4 contenedores, 8 GB). Para producción ejecutar make bootstrap tras configurar inventory/host_vars/platform-host.yml. Validar cada etapa con gates de verificación integrados.
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.