formbricks_form_manager/COOLIFY.md

Formbricks Vanity Server - Coolify Deployment Guide

Configuración para Coolify en VPS

Información del Deployment

• Dominio: your-vanity-server.com (configurable)
• Formbricks Instance: your-formbricks-instance.com (configurable)
• Puerto: 3011

Pasos para Desplegar en Coolify

1. Publicar Imagen en Docker Hub

# Login a Docker Hub
docker login

# Construir la imagen
docker build -t marcogll/soul23_form_mgr:latest .

# Publicar a Docker Hub
docker push marcogll/soul23_form_mgr:latest

2. Configurar en Coolify

1. Crear Nuevo Recurso

   • Ve a tu proyecto en Coolify
   • Click en "Add New Resource"
   • Selecciona "Docker Compose"

2. Configurar Docker Compose

   • Pega el contenido del archivo docker-compose.yml
   • O usa la imagen directamente desde Docker Hub

3. Variables de Entorno

   En Coolify, configura estas variables de entorno:

   FORMBRICKS_API_KEY=fbk_...
   ADMIN_API_TOKEN=...
   FORMBRICKS_ENV_ID=...
   FORMBRICKS_SDK_URL=https://feedback.soul23.cloud
   BASE_DOMAIN=https://forms.soul23.cloud
   

   💡 Nota: Asegúrate de configurar todas estas variables en Coolify para que coincidan con tu entorno.

4. Configurar Dominio

   • En Coolify, ve a "Domains"
   • Agrega: forms.soul23.cloud
   • Coolify configurará automáticamente SSL con Let's Encrypt

5. Configurar Red

   • Asegúrate de que el servicio esté en la red coolify
   • Esto ya está configurado en el docker-compose.yml

6. Volumen para Persistencia

   • El volumen formbricks_data se crea automáticamente
   • Los datos de SQLite se guardarán en /app/data

3. Desplegar

1. Click en "Deploy" en Coolify
2. Espera a que la imagen se descargue y el contenedor inicie
3. Verifica los logs en Coolify

4. Verificar Deployment

Una vez desplegado, verifica:

• Admin UI: https://forms.soul23.cloud/admin
• Ejemplo de encuesta: https://forms.soul23.cloud/socias/Contratos
  • Debe redirigir a: https://feedback.soul23.cloud/s/k40zfrs2r62ifbgavpumemlc

CToken: your_admin_token_here

Configuración Inicial

1. Acceder al Admin UI

URL: https://forms.soul23.cloud/admin
Token: your_admin_token_here

2. Configurar Aliases

1. Ve al Admin UI
2. Configura los aliases para tus proyectos:
   • socias → Environment your_environment_id_here
   • vanity → Environment cmbgr6u7s0009s201i45xtbtv

3. Usar las Encuestas

Tus encuestas estarán disponibles en:

• https://forms.soul23.cloud/{alias}/{nombre-encuesta}

Ejemplos:

• https://forms.soul23.cloud/socias/Contratos (redirige a Formbricks)
• https://forms.soul23.cloud/vanity/test (embebida)

Actualizar la Aplicación

Para actualizar a una nueva versión:

# 1. Construir nueva imagen
docker build -t marcogll/soul23_form_mgr:v1.1.0 .

# 2. Publicar
docker push marcogll/soul23_form_mgr:v1.1.0

# 3. En Coolify, actualiza la imagen en docker-compose.yml
# 4. Click en "Redeploy"

Troubleshooting

Ver Logs en Coolify

1. Ve a tu servicio en Coolify
2. Click en "Logs"
3. Verifica que el servidor inicie correctamente

Problemas Comunes

Error de conexión a Formbricks

• Verifica que FORMBRICKS_API_KEY sea correcta
• Verifica que feedback.soul23.cloud sea accesible desde el VPS

Base de datos no persiste

• Verifica que el volumen formbricks_data esté montado
• En Coolify, ve a "Volumes" y verifica que exista

SSL no funciona

• Coolify maneja SSL automáticamente
• Verifica que el dominio forms.soul23.cloud apunte a tu VPS
• Espera unos minutos para que Let's Encrypt emita el certificado

Backup de la Base de Datos

Para hacer backup de la base de datos SQLite:

# Conectarse al contenedor
docker exec -it formbricks-vanity sh

# Copiar la base de datos
cp /app/data/survey_mappings.db /tmp/backup.db

# Salir del contenedor
exit

# Copiar desde el contenedor al host
docker cp formbricks-vanity:/tmp/backup.db ./backup-$(date +%Y%m%d).db

Monitoreo

Coolify proporciona métricas automáticas. Puedes ver:

• CPU usage
• Memory usage
• Network traffic
• Container status

Recursos Adicionales

• Documentación de Coolify: https://coolify.io/docs
• Docker Hub: Publica tu imagen para fácil deployment
• Health Checks: Coolify monitorea automáticamente la salud del contenedor