Desplegar Coolify en VPS con una Imagen Preinstalada

Despliega Coolify en infraestructura VPS cuando desees una plataforma autohospedada para construir y operar aplicaciones, bases de datos y servicios en un servidor que controlas. La imagen de aplicación de VoyraCloud elimina el trabajo inicial de instalación de Coolify, mientras que tú sigues siendo responsable de los proyectos, credenciales, dominios, datos, actualizaciones, copias de seguridad, seguridad y capacidad del VPS.

TL;DR

La imagen de Coolify de VoyraCloud proporciona Coolify en Ubuntu 24.04 LTS para configuraciones elegibles de Cloud VPS y Residential IP VPS.
Crea el primer administrador de Coolify a través del túnel SSH mostrado en los detalles del recurso VPS. No expongas una página de registro no inicializada a Internet público.
La dirección del panel local inicial es http://127.0.0.1:8000 mientras el túnel SSH esté abierto. No es una URL pública.
Los puertos 80 y 443 son utilizados por el proxy de Coolify para aplicaciones desplegadas, validación de dominio y HTTPS. Los puertos de gestión 8000, 6001 y 6002 permanecen fuera de Internet público.
Apunta tu propio dominio al VPS e ingresa un https:// FQDN en Coolify para permitir que su proxy solicite y renueve un certificado de Let’s Encrypt.
Coolify puede desplegar desde repositorios Git, Dockerfiles, Docker Compose e imágenes de contenedores preconstruidas, pero las construcciones y bases de datos consumen los mismos recursos del VPS a menos que las muevas a otro lugar.
Haz copias de seguridad tanto de la instancia de Coolify como de la base de datos propia de cada aplicación, volumen persistente, archivos y secretos. Una copia de seguridad de la base de datos de Coolify por sí sola no es una copia de seguridad completa de la aplicación.
VoyraCloud no actualiza automáticamente tu instancia de Coolify después de la entrega. Revisa las versiones, haz una copia de seguridad primero y actualiza deliberadamente.

¿Qué es Coolify?

Coolify es una plataforma de despliegue autohospedada y de código abierto para ejecutar aplicaciones, bases de datos y servicios compatibles con Docker en servidores que controlas. Proporciona un panel web para conectar repositorios de origen, construir aplicaciones, gestionar variables de entorno, ver registros, asignar dominios, operar bases de datos y controlar despliegues.

Coolify se describe a sí mismo como una alternativa autohospedable a plataformas como Heroku, Netlify y Vercel. La diferencia importante es la propiedad operativa: Coolify se ejecuta en tu infraestructura y tus cargas de trabajo permanecen en servidores que administras. La plataforma añade automatización de despliegue, pero no convierte un VPS autogestionado en un servicio de hosting gestionado.

La introducción oficial de Coolify enumera el despliegue basado en Git, servicios compatibles con Docker, dominios personalizados, manejo automático de certificados, copias de seguridad en almacenamiento compatible con S3, webhooks, una API, monitoreo y un terminal de navegador entre sus capacidades.

Coolify es una buena opción cuando deseas:

Desplegar sitios web, APIs, trabajadores y aplicaciones de pila completa desde Git.
Ejecutar imágenes de Docker o proyectos de Docker Compose a través de una interfaz.
Operar cargas de trabajo de desarrollo, preproducción o pequeñas producciones en tu propio servidor.
Gestionar dominios, variables de entorno, registros de despliegue y verificaciones de salud de manera centralizada.
Albergar bases de datos y servicios junto a aplicaciones cuando el VPS tiene suficiente capacidad.

Es menos adecuado cuando nadie puede hacerse cargo de la administración de Linux, la seguridad de la aplicación, la recuperación de bases de datos o la respuesta a incidentes. Un panel amigable reduce el trabajo repetitivo; no elimina la necesidad de un operador.

¿Qué incluye la imagen de Coolify de VoyraCloud?

La imagen de la aplicación incluye un entorno de inicio de Coolify probado, no una aplicación empresarial preconstruida o una plataforma gestionada. Te permite comenzar en el flujo del primer administrador de Coolify en lugar de instalar manualmente las dependencias del sistema operativo y Coolify.

Incluido con la imagen	Gestionado por el usuario o no incluido
Ubuntu 24.04 LTS	Tu código de aplicación y arquitectura
Liberación fija de Coolify probada en la creación del recurso	Actualizaciones automáticas de Coolify después de la entrega
Servicios de Coolify basados en Docker y proxy integrado	Un sitio web desplegado, API, base de datos o servicio de un clic
Configuración persistente de Coolify en el disco del VPS	Recuperación de desastres automática fuera del servidor
Recuperación de servicio después de un reinicio normal del VPS	Alta disponibilidad o conmutación por error automática
Instrucciones del túnel SSH para el primer acceso	Un administrador de Coolify precreado
Puertos públicos 80 y 443 para aplicaciones y HTTPS	Un nombre de dominio o gestión de DNS
Puertos de gestión solo locales	Exposición pública de la página de registro
Acceso completo a la administración del VPS	Operaciones gestionadas de Linux, base de datos o aplicación

La página de recursos registra la versión de Coolify entregada cuando se crea el VPS. Si luego actualizas Coolify tú mismo, ese valor mostrado no se convierte en un inventario de software en vivo.

Para un entorno de contenedor de nivel inferior sin una plataforma de despliegue, compara este modelo con la guía de Docker en VPS con Portainer. Docker y Portainer exponen primitivas de contenedor directamente, mientras que Coolify añade flujos de trabajo de construcción, dominio, despliegue y servicio orientados a aplicaciones.

¿Cómo despliegas Coolify en VPS desde la imagen de la aplicación?

Comienza creando un VPS elegible de VoyraCloud, abriendo sus detalles de aplicación y utilizando el túnel SSH proporcionado antes de crear el primer administrador. El túnel es esencial porque la página de registro inicial puede otorgar control sobre la instancia de Coolify y el servidor que gestiona.

1. Crea un VPS con la imagen de Coolify

Abre la página de Coolify de VoyraCloud, continúa con el flujo de compra y selecciona una configuración elegible de Cloud VPS o Residential IP VPS. Elige cualquier región actualmente ofrecida por el producto seleccionado y confirma que Coolify está seleccionado en la sección de Imágenes.

VoyraCloud Cloud VPS es la opción de propósito general para alojamiento de aplicaciones, construcciones, APIs, bases de datos y herramientas para desarrolladores. Residential IP VPS también es compatible cuando una carga de trabajo legítima necesita específicamente las características de red de ese producto, pero una IP residencial no hace que Coolify sea más rápido, seguro o fácil de operar.

La guía de instalación oficial de Coolify establece un mínimo de dos núcleos de CPU, 2 GB de RAM y 30 GB de almacenamiento libre. Ese es un piso de inicio para la plataforma, no una promesa de capacidad para las aplicaciones que despliegas. Las construcciones, bases de datos, registros, imágenes de contenedores y datos persistentes utilizan recursos adicionales.

2. Copia el comando del túnel SSH

Espera hasta que el VPS esté listo, luego copia el comando completo del túnel SSH de la sección de Aplicación de la página de recursos. Utiliza el nombre de usuario SSH real, el puerto SSH y la dirección pública de tu VPS.

El comando sigue esta estructura:

ssh -p {ssh_port} \
  -L 8000:127.0.0.1:8000 \
  -L 6001:127.0.0.1:6001 \
  -L 6002:127.0.0.1:6002 \
  {ssh_user}@{server_ip}

Mantén la sesión SSH abierta. Los tres reenvíos soportan el panel, comunicación en tiempo real y terminal del navegador. Cerrar la sesión SSH cierra el túnel pero no detiene Coolify en el VPS.

Si uno de esos puertos locales ya está en uso en tu computadora, cambia solo el número en el lado izquierdo de ese mapeo. Por ejemplo, -L 18000:127.0.0.1:8000 utiliza el puerto local 18000 mientras aún llega a Coolify en el puerto del servidor 8000. Utiliza la URL local correspondiente en tu navegador.

3. Crea el primer administrador

Abre http://127.0.0.1:8000 mientras el túnel esté conectado y crea el primer administrador de Coolify de inmediato. Utiliza una dirección de correo electrónico única y una contraseña fuerte que no se reutilice en otro lugar.

La dirección es local a tu computadora y solo funciona a través de la conexión SSH autenticada. No la reemplaces con http://{server_ip}:8000 ni abras puertos de gestión a Internet como un atajo. La guía de instalación oficial de Coolify advierte que otra persona que llegue primero a una página de registro no inicializada puede obtener control total del servidor.

Después del registro:

Inicia sesión con el nuevo administrador.
Confirma que el servidor localhost aparece como alcanzable.
Revisa la configuración de actualizaciones y mantén las actualizaciones automáticas desactivadas para una operación de producción controlada.
Verifica el uso de disco y memoria antes de desplegar una aplicación.
Mantén el túnel SSH como la ruta de gestión hasta que configures un dominio de confianza.

4. Despliega una pequeña primera aplicación

Utiliza un pequeño repositorio público o una imagen de contenedor preconstruida para el primer despliegue para que puedas validar el camino completo antes de agregar una base de datos o credenciales privadas. Coolify soporta repositorios Git públicos y privados, Dockerfiles, Docker Compose, imágenes de Docker preconstruidas y paquetes de construcción.

Una prueba controlada inicial debería verificar:

Coolify puede alcanzar la fuente seleccionada.
La construcción finaliza sin agotar CPU, memoria o disco.
El contenedor de la aplicación se vuelve saludable.
Los registros son visibles y no contienen errores de inicio recurrentes.
La aplicación responde a través de su dominio asignado.
Un reinicio del VPS no elimina su configuración o datos persistentes.

El repositorio de ejemplos de Coolify contiene pequeños ejemplos de aplicaciones adecuados para aprender. Revisa el ejemplo antes del despliegue, porque el código público sigue siendo entrada de terceros que se ejecuta en tu servidor.

¿Cómo funcionan los dominios y HTTPS en Coolify?

Coolify puede configurar su proxy y solicitar un certificado de Let’s Encrypt después de que tu dominio se resuelva al VPS y ingreses un https:// FQDN. VoyraCloud no incluye el dominio ni controla sus registros DNS.

Para el panel de Coolify o una aplicación desplegada:

Crea un registro A que apunte el nombre de host elegido a la dirección IPv4 del VPS.
Espera hasta que el DNS público devuelva la dirección esperada.
Ingresa el nombre de host completo en Coolify usando el esquema https://.
Mantén los puertos TCP públicos 80 y 443 accesibles para que el proxy pueda servir tráfico y completar la validación del certificado.
Espera la emisión del certificado, luego abre la URL final de HTTPS.
Confirma que HTTP simple redirige a HTTPS y que el navegador no muestra ninguna advertencia de certificado.
Prueba el comportamiento de renovación antes de que el certificado se vuelva crítico para un servicio de producción.

La guía oficial de dominios de Coolify explica que ingresar un FQDN HTTPS hace que el proxy integrado Traefik o Caddy genere configuración de enrutamiento, solicite un certificado de Let’s Encrypt y maneje la renovación. Si la emisión falla, Coolify puede servir un certificado autofirmado, lo que mantiene el punto de acceso alcanzable pero aún causa una advertencia en el navegador. Trata esa advertencia como una configuración de HTTPS no confiable fallida y corrige DNS, alcanzabilidad, límites de tasa o configuración del proxy.

Después de que un dominio de panel confiable funcione, puedes continuar usando el túnel SSH o usar el dominio HTTPS de acuerdo con tu política de acceso. No publiques los puertos 8000, 6001 o 6002 simplemente porque el panel tiene una contraseña de administrador. La guía de firewall de Coolify permite que esos puertos se cierren cuando se utiliza un dominio personalizado y un proxy integrado.

¿Qué método de despliegue deberías elegir?

Elige el método de despliegue más simple que coincida con cómo se construye y mantiene tu aplicación. Cada capa de construcción adicional o servicio público aumenta el uso de recursos y el trabajo operativo.

Método de despliegue	Mejor ajuste	Responsabilidad principal
Paquete de construcción	Frameworks comunes con estructura de proyecto convencional	Verificar comandos de construcción y inicio detectados
Dockerfile	Aplicaciones que necesitan una construcción de imagen controlada y reproducible	Mantener el Dockerfile y las imágenes base
Docker Compose	Aplicaciones de múltiples contenedores y proyectos de Compose existentes	Revisar redes, volúmenes, puertos y dependencias de servicio
Imagen de Docker preconstruida	Software ya publicado en un registro de confianza	Fijar una versión de imagen y verificar su origen
Servicio de un clic	Herramientas autohospedadas compatibles con una plantilla de Coolify	Revisar variables generadas, almacenamiento y versiones de imagen ascendentes

Coolify ejecuta aplicaciones como contenedores de Docker. Construir el origen en el mismo VPS puede crear picos de CPU, memoria y disco, especialmente para grandes dependencias de JavaScript, compilación nativa o construcciones de Docker de múltiples etapas. Si las construcciones hacen que el servidor no responda, aumenta el tamaño del VPS o utiliza un servidor de construcción separado en lugar de asumir que el panel puede aislar trabajo ilimitado.

Fija las versiones de imagen de aplicación y base de datos donde sea práctico. Una etiqueta flotante puede extraer una versión materialmente diferente durante un redepliegue rutinario, creando una actualización que no planeaste.

¿Cómo deberías dimensionar un VPS para Coolify?

Dimensiona el VPS para Coolify más el uso máximo de recursos de cada construcción, aplicación, base de datos, flujo de registro, copia de seguridad e imagen de contenedor almacenada en el servidor. El mínimo en el flujo de compra es un umbral de elegibilidad para una carga de trabajo inicial pequeña, no una recomendación universal.

Patrón de carga de trabajo	Presión principal	Guía de planificación
Un pequeño sitio estático	Construcción de CPU y almacenamiento de imagen	Mantener margen para reconstrucciones y actualizaciones
API sin una base de datos local	Picos de memoria y tráfico	Monitorear memoria de procesos y comportamiento de reinicio
Aplicación web más base de datos	RAM, latencia de disco y espacio de copia de seguridad	Proteger los datos de la base de datos con almacenamiento persistente y volcado nativo
Varias aplicaciones	Memoria, registros e imágenes agregadas	Medir picos combinados, no uso inactivo
Grandes construcciones de origen	CPU, RAM, archivos temporales y capas de imagen	Considerar un plan más grande o un servidor de construcción separado
Servicios con estado	Durabilidad del disco, crecimiento y recuperación	Planificar retención, copia de seguridad fuera del servidor y pruebas de restauración

Observa el espacio libre en disco tan de cerca como la memoria. Las capas de imagen de Docker, cachés de construcción, historial de despliegue, registros, archivos de base de datos y copias de seguridad pueden crecer hasta que los despliegues fallen o las bases de datos se detengan. La limpieza debería eliminar solo artefactos que entiendas; eliminar un volumen activo no es mantenimiento rutinario.

Si una carga de trabajo es crítica para el negocio, un VPS único más grande mejora la capacidad pero no proporciona alta disponibilidad. Las copias de seguridad externas, el monitoreo, la conmutación por error y un diseño de múltiples servidores son requisitos separados. Un despliegue de Uptime Kuma autohospedado puede proporcionar un punto de vista de monitoreo, pero no debería compartir cada dominio de falla con el servicio que monitorea.

¿Qué debes respaldar?

Haz copias de seguridad de los datos del plano de control de Coolify y del estado de cada carga de trabajo desplegada como capas de recuperación separadas. El proceso de copia de seguridad oficial de Coolify protege la configuración de Coolify, pero no incluye automáticamente cada volumen de aplicación o base de datos.

Un plan de recuperación completo debería cubrir:

La copia de seguridad de la base de datos de Coolify.
El APP_KEY de Coolify, almacenado de forma segura fuera del VPS.
Claves SSH gestionadas por Coolify necesarias para reconectar servidores gestionados.
Volcados nativos de base de datos para PostgreSQL, MySQL, MariaDB, MongoDB u otros servicios con estado.
Volúmenes persistentes y archivos de aplicación montados.
Repositorios Git, Dockerfiles, archivos de Compose y documentación de despliegue.
Variables de entorno y secretos a través de un proceso seguro y recuperable.
Registros DNS, propiedad de dominio, suposiciones de proxy y dependencias de certificado.
Un orden de restauración probado en otro servidor.

No almacenes la única copia de seguridad en el mismo VPS. Una falla de disco, compromiso de cuenta, eliminación accidental o eliminación del VPS puede eliminar tanto la carga de trabajo activa como una copia local.

La guía oficial de copia de seguridad y restauración de Coolify señala explícitamente que una copia de seguridad de la instancia de Coolify no respalda los datos de la aplicación, como los montajes de volumen. Prueba la restauración con la misma versión de Coolify utilizada para crear la copia de seguridad, luego verifica proyectos, credenciales, aplicaciones, bases de datos y dominios antes de considerar exitosa la recuperación.

¿Cómo deberías actualizar Coolify y las aplicaciones desplegadas?

Actualiza Coolify y tus aplicaciones deliberadamente, con una copia de seguridad verificada y un plan de reversión para cada capa con estado. La imagen de VoyraCloud entrega una versión fija de Coolify y no actualiza continuamente tu instancia.

Antes de una actualización de Coolify:

Lee las notas de la versión oficial y los cambios importantes.
Registra la versión actualmente en ejecución.
Haz una copia de seguridad de la base de datos de Coolify, APP_KEY, claves SSH, aplicaciones, bases de datos y volúmenes.
Confirma que hay suficiente espacio libre en disco para nuevas imágenes y trabajo de migración.
Programa una ventana de mantenimiento.
Actualiza a una versión específica revisada en lugar de un objetivo flotante no revisado.
Prueba el inicio de sesión, la alcanzabilidad del servidor, una construcción, un despliegue, registros, terminal, dominios, HTTPS y recuperación de reinicio.
Restaura en un sistema separado cuando necesites probar la reversión en lugar de asumir que una imagen de contenedor más antigua es suficiente.

Coolify admite actualizaciones automáticas, semiautomáticas y manuales. Para una instancia de producción, las actualizaciones manuales controladas o semiautomáticas revisadas reducen sorpresas. La guía oficial de actualización también recomienda hacer una copia de seguridad antes de una actualización.

Las actualizaciones de aplicaciones son separadas. Una actualización de Coolify no actualiza cada aplicación de manera segura, y una nueva imagen de aplicación puede incluir migraciones de base de datos que dificultan la reversión. Fija versiones, revisa cambios ascendentes, haz copias de seguridad de datos, despliega, prueba y monitorea cada carga de trabajo de acuerdo con sus propios requisitos.

Errores comunes a evitar

Los errores más graves de Coolify involucran exposición pública de gestión, copias de seguridad incompletas y tratar una plataforma de despliegue como infraestructura ilimitada. Evita estos patrones:

No expongas una página de registro de Coolify no inicializada a Internet público.
No abras los puertos 8000, 6001 o 6002 como un atajo alrededor del túnel SSH o la configuración de dominio.
No asumas que UFW por sí solo bloquea los puertos publicados por Docker; verifica la alcanzabilidad desde una red externa.
No coloques bases de datos en puertos públicos a menos que se requiera acceso remoto y esté asegurado.
No cometas secretos de entorno en Git ni los pegues en registros de construcción públicos.
No uses etiquetas de contenedor flotantes para servicios importantes con estado.
No asumas que un inicio de contenedor exitoso significa que una aplicación está saludable.
No trates el VPS mínimo elegible como suficiente para construcciones arbitrarias o múltiples bases de datos.
No mantengas la única copia de seguridad en el mismo VPS.
No confundas una copia de seguridad de la base de datos de Coolify con copias de seguridad de volumen de aplicación o base de datos.
No habilites actualizaciones desatendidas sin entender migraciones y reversión.
No esperes que un VPS proporcione alta disponibilidad.

FAQ

¿Qué significa autohospedar Coolify en un VPS?

Significa ejecutar la plataforma de despliegue Coolify en un servidor Linux virtual que controlas. Coolify gestiona construcciones, contenedores, dominios, servicios y flujos de trabajo de despliegue, mientras que tú gestionas el VPS, aplicaciones, datos, credenciales, actualizaciones, seguridad, copias de seguridad y capacidad.

¿Necesito instalar Coolify manualmente?

No, la imagen de aplicación de VoyraCloud entrega Coolify preinstalado. Crea un VPS elegible, copia el comando del túnel SSH de la página de recursos, abre la URL del panel local y crea el primer administrador. Aún despliegas y configuras tus propias aplicaciones.

¿Por qué no está disponible el panel de Coolify en la IP pública del servidor?

El panel inicial se accede intencionadamente a través de un túnel SSH porque el primer registro otorga control de alto privilegio. Mantén el túnel proporcionado abierto y visita http://127.0.0.1:8000. Más tarde, puedes configurar tu propio dominio de panel y HTTPS de confianza a través del proxy de Coolify.

¿Qué puertos necesita Coolify?

Los puertos públicos 80 y 443 soportan tráfico de aplicaciones, validación de dominio y HTTPS, mientras que los puertos de gestión 8000, 6001 y 6002 permanecen locales en la imagen de VoyraCloud. SSH utiliza el puerto mostrado para tu propio VPS. Puertos adicionales dependen de las aplicaciones que publiques deliberadamente.

¿Coolify proporciona automáticamente HTTPS?

Coolify puede configurar automáticamente su proxy y solicitar un certificado de Let’s Encrypt después de que apuntas un dominio al VPS e ingresas un FQDN HTTPS. No se incluye un dominio, el DNS debe resolverse correctamente y los puertos públicos 80 y 443 deben ser accesibles. Un respaldo autofirmado no es HTTPS confiable para el navegador.

¿Puedo desplegar repositorios Git privados?

Sí, Coolify soporta flujos de trabajo de repositorios privados a través de integraciones de Git soportadas y claves de despliegue. Usa credenciales de privilegio mínimo, revisa la exposición de webhooks, rota claves cuando cambie el acceso y nunca almacenes credenciales de repositorio en registros o código públicos.

¿Coolify respalda cada aplicación desplegada?

No, una copia de seguridad de la instancia de Coolify no protege automáticamente cada base de datos de aplicación, volumen o archivo. Haz copias de seguridad del plano de control de Coolify, bases de datos de aplicación, almacenamiento persistente, configuración, secretos y documentación de recuperación por separado, luego prueba la restauración completa.

¿Es suficiente el VPS mínimo elegible para múltiples aplicaciones?

No necesariamente. El mínimo soporta la plataforma Coolify y una carga de trabajo ligera inicial, mientras que la capacidad real depende del tamaño de la construcción, la memoria de la aplicación, bases de datos, registros, tráfico, copias de seguridad y crecimiento del almacenamiento. Monitorea el uso real y muévete a una configuración más grande antes de que la presión de recursos afecte la fiabilidad.

¿VoyraCloud actualiza Coolify por mí?

No, Coolify se gestiona a sí mismo después de que se entrega el VPS. Mantén las actualizaciones automáticas controladas, revisa las notas de lanzamiento ascendentes, haz copias de seguridad de todos los datos requeridos y actualiza a una versión específica probada. Las actualizaciones del sistema operativo y de la aplicación siguen siendo responsabilidades separadas.

¿Puede Coolify hacer que un VPS sea altamente disponible?

No, un VPS de Coolify sigue siendo un dominio de falla. Un servidor más grande puede proporcionar más capacidad, pero la alta disponibilidad requiere servidores separados, balanceo de carga, estado replicado donde sea apropiado, monitoreo independiente, copias de seguridad externas y conmutación por error probada.

Conclusión

Autohospeda Coolify en un VPS cuando desees automatización de despliegue orientada a aplicaciones sin renunciar al control del servidor subyacente. La imagen de aplicación de VoyraCloud te brinda un entorno de inicio probado y un camino de primer acceso privado, mientras que Coolify proporciona flujos de trabajo de Git, Docker, dominio, HTTPS, base de datos y servicio.

Comienza con el túnel SSH, crea el primer administrador, despliega una pequeña aplicación y valida un dominio real con HTTPS de confianza. Luego agrega cargas de trabajo gradualmente, mide el uso de recursos, fija versiones, protege secretos, haz copias de seguridad de cada capa con estado y prueba la recuperación antes de que el servidor se vuelva crítico.

Para un flujo de trabajo de gestión de contenedores de nivel inferior, compara este enfoque con ejecutar Docker y Portainer en un VPS.

Explora la imagen de aplicación Coolify de VoyraCloud para comenzar desde el entorno preinstalado.