Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

terraform-provider-coolify

Proveedor Terraform para Coolify, plataforma PaaS auto-alojada. Gestiona 57 recursos y 71 fuentes de datos para aprovisionar aplicaciones, bases de datos, servidores y backups mediante HCL versionado, integrando CI/CD y recuperación ante desastres en entornos self-hosted.

Ficha actualizada 24 sept 2026, 23:45 · upstream 24 sept 2026, 23:26 · release v0.1.23

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es terraform-provider-coolify

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este repositorio implementa un proveedor oficial para Terraform y OpenTofu que permite gestionar la infraestructura de una instancia Coolify como código. Ofrece cobertura completa sobre 57 recursos administrativos, incluyendo proyectos, servidores (Hetzner, DigitalOcean, Vultr), aplicaciones desde Git o Dockerfiles, bases de datos (PostgreSQL, MySQL, Redis, MongoDB, ClickHouse) y almacenamiento S3. La base de código está escrita principalmente en Go con soporte para Python, garantizando integración directa con la API de Coolify.

El proveedor facilita la automatización del ciclo de vida de las aplicaciones, permitiendo definir entornos consistentes (dev, staging, prod), gestionar variables de entorno, configuraciones de dominios con TLS automático y planes de backup programados. Incluye más de 1670 pruebas unitarias y de aceptación para validar la estabilidad de las operaciones antes de aplicar cambios en producción.

Destaca por su enfoque en la reproducibilidad y la seguridad, permitiendo revisar cambios en pull requests y adoptar recursos existentes mediante importación sin reconstruir todo el stack desde cero. Soporta versiones recientes de Coolify (4.1 a 4.3) y ofrece guías detalladas para migración, integración con CI/CD y operaciones Day-2 como actualizaciones o rollbacks.

CASOS DE USO
  • Despliegue repetible de aplicaciones web y APIs en servidores gestionados por Coolify mediante archivos HCL versionados.
  • Gestión automatizada de bases de datos relacionales y NoSQL (PostgreSQL, MySQL, Redis, MongoDB) con backups programados.
  • Provisión de infraestructura híbrida integrando nubes públicas (Hetzner, DigitalOcean) con la PaaS local Coolify.
  • Recuperación ante desastres mediante la recreación exacta del stack de aplicaciones tras fallos o cambios en la configuración.
  • Auditoría y control de cambios en la infraestructura de desarrollo al aplicar revisiones de código antes de desplegar.
PUNTOS DESTACADOS
  • Soporte nativo para 57 recursos y 71 fuentes de datos que cubren casi todas las funcionalidades de la UI de Coolify.
  • Más de 1670 pruebas unitarias y de aceptación que aseguran la estabilidad del proveedor en diferentes versiones de Coolify.
  • Capacidad de importar recursos existentes desde la interfaz gráfica para adoptar Terraform gradualmente sin reconstruir todo el stack.
  • Integración directa con CI/CD pipelines para automatizar despliegues, actualizaciones y rollbacks de forma segura.
  • Gestión unificada de variables de entorno, dominios con TLS automático y configuraciones de notificaciones (Slack, Discord, Telegram).
PRECAUCIONES
  • Requiere una instancia Coolify operativa en la que se conecte el proveedor mediante token y endpoint.
  • La cobertura de recursos puede variar ligeramente entre versiones de Coolify (4.1 a 4.3), consultando la guía de soporte.
  • Dependencia de la API subyacente de Coolify; si esta cambia, el proveedor podría requerir actualizaciones para mantener compatibilidad.
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

terraform apply deploying an app via CoolifyTerraform Provider for Coolify
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO40 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Instalar el proveedor en el repositorio de Terraform o OpenTofu. Configurar variables coolify_endpoint y coolify_token. Inicializar Terraform y ejecutar terraform apply siguiendo los ejemplos de la carpeta examples/. Para entornos existentes, usar la guía de importación para adoptar recursos sin recrearlos. Verificar compatibilidad con la versión de Coolify instalada (4.1-4.3).

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
GoPython
SERVICIOS
PostgreSQLMySQLRedisMongoDBS3/MinIOClickHouse
BASES DE DATOS
PostgreSQLMySQLRedisMongoDBClickHouse
PUERTOS
30008000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.