Cómo instalar Coolify, configurar GitHub y vincular Cloudflare R2 en un VPS Ubuntu

Coolify es una alternativa open-source a plataformas como Heroku, Vercel o Netlify que permite desplegar aplicaciones, bases de datos y servicios en tu propio servidor. En esta guía verás cómo instalarlo en un VPS Ubuntu, integrar despliegues automáticos con GitHub y configurar almacenamiento de objetos en Cloudflare R2.

1. Requisitos previos

• Un VPS con Ubuntu 22.04+ y acceso SSH.
• Usuario con permisos de sudo.
• Un dominio o subdominio apuntando al servidor (para el panel de Coolify).
• Cuenta de GitHub con repositorio de tu aplicación.
• Cuenta de Cloudflare con R2 habilitado.

2. Instalar Coolify en Ubuntu

Conéctate al servidor y ejecuta:

# Instalar Coolify
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

Cuando termine, accede al panel en https://TU_DOMINIO y configura la cuenta de administrador.

3. Conectar GitHub a Coolify

1. Entra al panel de Coolify: Settings > Git Integrations.
2. Haz clic en Add GitHub Integration.
3. Autoriza a Coolify en tu cuenta de GitHub.
4. Selecciona el repositorio de tu proyecto.
5. Define los comandos de build (ejemplo para React/Vite):

   npm install
   npm run build
   

6. Configura la carpeta de salida (dist o build según el framework).

A partir de ahora, cada push a main activará un despliegue automático.

4. Vincular Cloudflare R2 en Coolify

Cloudflare R2 es un servicio de almacenamiento S3-compatible sin costos de salida. Perfecto para archivos estáticos, imágenes y backups.

Obtener credenciales de Cloudflare R2

1. En tu panel de Cloudflare, entra a R2.
2. Crea un Bucket.
3. Genera un par de credenciales (Access Key ID y Secret Access Key).
4. Anota el Endpoint del bucket, algo como:

   https://.r2.cloudflarestorage.com

Configurar variables en Coolify

1. En tu proyecto dentro de Coolify, entra a Environment Variables.
2. Agrega:

   ACCESS_KEY_ID=tu_access_key
   SECRET_ACCESS_KEY=tu_secret_key
   REGION=auto
   ENDPOINT=https://ID.r2.cloudflarestorage.com
   BUCKET=nombre_del_bucket
   

3. En tu aplicación, usa librerías compatibles con S3 (ej: AWS SDK en Node.js, boto3 en Python, etc.).

5. Prueba de integración

Haz un git push origin main en tu repositorio y revisa el panel de Coolify: la aplicación debería desplegarse automáticamente. Luego, sube un archivo a R2 desde tu código y verifica que se almacene en el bucket.

6. Buenas prácticas

• Activa HTTPS con certificados automáticos de Let’s Encrypt desde Coolify.
• Configura backups automáticos de tu base de datos en R2.
• Separa entornos: staging y producción.
• Monitorea logs y métricas desde el panel de Coolify.

Conclusión

Con Coolify en tu VPS puedes tener un sistema de CI/CD con GitHub y almacenamiento de objetos en Cloudflare R2 sin depender de servicios de terceros. Es una solución potente, económica y flexible para desarrolladores y equipos que quieren controlar su infraestructura.

👉 ¿Quieres que instalemos y configuremos Coolify, GitHub y Cloudflare R2 en tu VPS?
Solicítalo aquí.