Qué es SmallCountry¶
SmallCountry es un ecosistema digital soberano para una finca regenerativa. Infraestructura real corriendo sobre hardware propio, construida con software libre y documentada para que cualquier persona —del campo a la ciudad— pueda entenderla, usarla y mantenerla sin depender de nadie.
Es tu nube personal. Vive en tu casa, no en la de otro.
Definición¶
SmallCountry no es un producto. No es un SaaS. No es una startup. Es un sistema operativo documental para la vida rural y profesional que integra:
- Hardware propio gestionado con Proxmox (hipervisor de virtualización) y ZFS (sistema de archivos con integridad de datos)
- Más de 82 servicios de software libre organizados en capas
- Sensores de campo (ESP32 (microcontrolador con WiFi y Bluetooth), Shelly (actuador eléctrico WiFi), LoRa (radio de largo alcance y bajo consumo)) que monitorizan colmenas, cultivos, clima y animales
- Inteligencia artificial local que corre sin enviar datos a ninguna API externa
- 18 roles humanos documentados — del agricultor al administrador de sistemas —
- Una constitución operativa con principios, compromisos, mecanismos de defensa y runbooks
Origen¶
SmallCountry nace de una necesidad concreta: una finca de 7 hectáreas en Garganta la Olla (Cáceres) necesitaba monitorizar colmenas, cultivos y clima sin depender de servicios externos que podrían dejar de funcionar —o de existir— en cualquier momento.
La respuesta fue construir una infraestructura digital propia con tres reglas:
- Todo software libre. Si el proveedor desaparece, el código sigue ahí.
- Todo documentado. Si la persona administradora no está, cualquiera puede seguir el runbook.
- Todo funciona sin internet. Porque en el campo la fibra se corta, la cobertura falla y la tormenta tumba el repetidor.
Lo que empezó como un servidor casero para Nextcloud es hoy un ecosistema documentado con 33 ADRs (Registro de Decisiones de Arquitectura), 82 servicios fichados y 14 proyectos sobre el terreno.
Las cuatro capas¶
SmallCountry se organiza en cuatro capas concéntricas. Cada capa depende solo de la que tiene debajo. Ninguna capa depende de servicios externos.
1. Hardware — Donde vive todo¶
Cuatro ordenadores con nombres de deidades egipcias. Cada uno tiene un trabajo concreto y no se mezclan:
- Ra es el servidor principal. Ahí viven los archivos, las fotos, el correo y la mayoría de servicios.
- Horus tiene una tarjeta gráfica potente. Es el que ejecuta la inteligencia artificial local.
- Geb vive en la finca, conectado a las placas solares y las baterías. Controla la energía.
- Thoth es un ordenador pequeño (Raspberry Pi) en otra ubicación. Guarda las copias de seguridad.
2. Infraestructura — Cómo se organiza el hardware¶
El hardware bruto no sirve de mucho. Hace falta una capa que lo organice:
- Proxmox divide cada ordenador en compartimentos independientes (LXC, contenedor ligero de Proxmox). Si un servicio falla, no arrastra a los demás.
- ZFS (sistema de archivos con integridad de datos) protege los datos. Hace copias instantáneas cada 15 minutos, comprueba que no se corrompan y permite volver atrás si algo sale mal.
- Docker (motor de contenedores) empaqueta los programas para que se instalen igual siempre, sin sorpresas.
- Red interna (vmbr, puente de red virtual de Proxmox) conecta los contenedores entre sí sin exponerlos a internet.
3. Servicios — Lo que usas¶
Aquí viven los programas que SmallCountry ofrece. Se organizan en categorías:
- Identidad: Un único usuario y contraseña para todo (Authentik).
- Archivos y fotos: Tu propia nube privada (Nextcloud, Immich).
- Comunicación: Chat y videollamadas cifradas (Matrix, Jitsi).
- Campo: Sensores de colmenas, estación meteorológica, cuaderno digital (farmOS).
- IA local: Asistente de voz y texto que no envía tus datos a nadie (Hermes Agent, Ollama).
- Ocio: Películas, música, libros (Jellyfin, Navidrome, Audiobookshelf).
- Empresa: Facturación, CRM, tienda online (FacturaScripts, Mautic).
Cada servicio tiene un tier de criticidad (S/A/B/C/D) que indica cuánto daño hace si falla.
4. Personas — Quienes usan el sistema¶
Las personas no son usuarias genéricas. 18 roles documentados describen quién usa cada parte del sistema y con qué herramientas. Cada rol tiene su panel de inicio y sus accesos.
flowchart TD
subgraph Capa4["👥 Capa 4 — Personas"]
direction LR
Vesta["Vesta · Hogar"]
Demeter["Deméter · Cultivos"]
Melissa["Melissa · Colmenas"]
Mercurio["Mercurio · Empresa"]
Higia["Higía · Salud"]
end
subgraph Capa3["📦 Capa 3 — Servicios"]
direction LR
Auth["Identidad · Authentik"]
Files["Archivos · Nextcloud · Immich"]
IoT["Campo · farmOS · Node-RED"]
IA["IA Local · Ollama · Hermes"]
Backup["Backups · PBS · Restic"]
end
subgraph Capa2["🔧 Capa 2 — Infraestructura"]
direction LR
Proxmox["Proxmox VE · virtualización"]
ZFS["ZFS · protección datos"]
Docker["Docker · empaquetado"]
Red["Red interna · vmbr · Pi-hole"]
end
subgraph Capa1["⚡ Capa 1 — Hardware"]
direction LR
Ra["Ra · servidor principal"]
Horus["Horus · IA y GPU"]
Geb["Geb · energía solar"]
Thoth["Thoth · backup offsite"]
end
Capa1 --> Capa2 --> Capa3 --> Capa4
style Capa1 fill:#c8e6c9,stroke:#2e7d32,color:#000
style Capa2 fill:#bbdefb,stroke:#1565c0,color:#000
style Capa3 fill:#f8bbd0,stroke:#c2185b,color:#000
style Capa4 fill:#ffe082,stroke:#f57f17,color:#000
Decisiones críticas¶
Cada decisión importante de la arquitectura está documentada como ADR (Architecture Decision Record). Estas son las que definen los cimientos:
| ADR | Decisión | Por qué importa |
|---|---|---|
| ADR-003 | Operación offline-first | Todo funciona sin internet. La fibra puede caerse durante semanas. |
| ADR-006 | ZFS como almacenamiento | Snapshots cada 15 minutos. Datos a prueba de corrupción. |
| ADR-014 | Authentik como identidad | Un solo usuario y contraseña para todo. 2FA obligatorio. |
| ADR-018 | LXC como unidad de aislamiento | Cada servicio en su contenedor. Si uno falla no arrastra a los demás. |
| ADR-022 | Modo isla | Operación autónoma sin internet. Punto de acceso local propio. |
| ADR-023 | Software libre obligatorio | Sin dependencia de proveedores. El código siempre está disponible. |
| ADR-005 | Doble VPN (NetBird + WireGuard) | Redundancia en las comunicaciones entre nodos. |
| ADR-016 | Backup 3-2-1 | Tres copias, dos medios, una externa. Sin excepciones. |
Qué no es SmallCountry¶
SmallCountry no es:
- Un producto comercial. No se vende. No tiene precio. No hay plan de negocio.
- Un SaaS. No alquilas espacio en el servidor de otro. El hardware es tuyo.
- Una distribución Linux. No es un sistema operativo que instalas. Es una arquitectura que replicas.
- Un proyecto comunitario de masas. No busca escalar a miles de usuarios. Cada instancia es soberana.
- Una solución mágica. Requiere hardware, tiempo y ganas de aprender. No promete disponibilidad 99.9%.
- Un sistema cerrado. Todo está documentado para que cualquiera pueda auditarlo, replicarlo o bifurcarlo.
SmallCountry es documentación ejecutable. Planos. Instrucciones. Un manual de montaje para tu propia soberanía digital.
Para seguir leyendo¶
- Filosofía y manifiesto — Los siete principios fundacionales
- Principios inmutables — Las 12 reglas de diseño
- Diagramas de arquitectura — Todos los diagramas en un solo lugar
- Dependencias entre servicios — Qué depende de qué
- Índice completo de ADRs — Todas las decisiones arquitectónicas