incus-compose
incus-compose es un sustituto drop-in para docker compose que ejecuta archivos compose.yaml sobre Incus, permitiendo usar la API completa de Incus como escape hatch cuando el estándar Compose no basta.
Ficha actualizada 22 sept 2026, 6:04 · upstream 22 sept 2026, 6:04 · release v1.3.4
Qué es incus-compose
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
incus-compose permite ejecutar archivos compose.yaml existentes sin reescribirlos, utilizando Incus como motor en lugar de Docker. Soporta imágenes OCI desde cualquier registro (docker.io, ghcr.io), redes bridge con IPs estáticas, volumes con UID/GID shifting y despliegues air-gapped donde se pull inicial y luego se ejecuta offline.
Incluye extensiones nativas como backup de proyectos que snapshot data volumes en un proyecto separado, port-forwarding para TCP local a instancias publicadas o no, y ic-healthd para healthchecks con depends_on: service_healthy. Usa compose-go para parsing, .env interpolation, profiles, secrets y configs.
Requiere Incus 7.0.2 (LTS) o 7.5+, podman/docker para builds locales y un remote HTTPS con OCI registries añadidos. Está licenciado bajo Apache 2.0 y usa librerías como go-selfupdate para self-update, dominikbraun/graph para dependency graph y bradleyjkemp/cupaloy para snapshot testing.
- Despliegue de stacks multi-servicio en servidores bare-metal o VMs con Incus
- Migración de archivos docker-compose.yml existentes a Incus sin reescribir sintaxis
- Despliegues air-gapped con pull inicial conectado y ejecución offline posterior
- Gestión de bases de datos PostgreSQL con healthchecks nativos y dependencias service_healthy
- Orquestación de aplicaciones web con dependencias entre servicios y redes bridge estáticas
- Compatibilidad total con sintaxis compose.yaml existente sin reescritura
- Soporte nativo para redes bridge con IPs estáticas y port publishing vía proxy devices
- Capacidad air-gapped con --pull never y cache OCI persistente que sobrevive down/up
- Extensiones como backup de proyectos y port-forwarding sin reconfigurar el stack
- Uso de ic-healthd para dependencias service_healthy y ordering de inicio
- Proyecto isolation y project-wide resource limits vía x-incus
- Requiere Incus específico (7.0.2+ o 7.5+) sin soporte para Docker Desktop/WSL
- Necesita configuración inicial de remotes HTTPS con OCI registries añadidos
- Algunos comandos docker-compose pueden no ser compatibles al 100% según matriz oficial
- Depende de podman/docker para builds locales (--build)
- Features avanzados requieren overrides x-incus o compose.incus.yaml
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.
Instalar en host con Incus 7.0.2+ o 7.5+, configurar remote HTTPS con OCI registries añadidos, usar --pull never para air-gapped, verificar compatibilidad con matriz oficial antes de producción, y considerar overrides x-incus para features avanzadas como GPU/USB/raw disk.
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.