mirror of
https://github.com/marcogll/formbricks_form_manager.git
synced 2026-01-13 21:35:17 +00:00
feat: Initial release of Formbricks Vanity Server
This commit is contained in:
Marco Gallegos
179
COOLIFY.md
Normal file
179
COOLIFY.md
Normal file
@@ -0,0 +1,179 @@
|
||||
# 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
|
||||
|
||||
```bash
|
||||
# Login a Docker Hub
|
||||
docker login
|
||||
|
||||
# Construir la imagen
|
||||
docker build -t your-dockerhub-username/formbricks-vanity-server:latest .
|
||||
|
||||
# Publicar a Docker Hub
|
||||
docker push your-dockerhub-username/formbricks-vanity-server: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_6QpdF1eC0E9umr9HjWUBaTxO_ispeHZYd-dI_EK9m2Q
|
||||
ADMIN_API_TOKEN=9HiRr6K0Hfp2I4RgoLLsXr
|
||||
FORMBRICKS_ENV_ID=cmbgr9ipo000ls201jpy12fbi,cmbgr9ipk000gs201rcukyfr7
|
||||
```
|
||||
|
||||
> ⚠️ **Importante**: No incluyas `FORMBRICKS_SDK_URL` ni `BASE_DOMAIN` en las variables de entorno de Coolify, ya que están hardcodeadas en el docker-compose.yml
|
||||
|
||||
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`
|
||||
|
||||
## Configuración Inicial
|
||||
|
||||
### 1. Acceder al Admin UI
|
||||
|
||||
```
|
||||
URL: https://forms.soul23.cloud/admin
|
||||
Token: 9HiRr6K0Hfp2I4RgoLLsXr
|
||||
```
|
||||
|
||||
### 2. Configurar Aliases
|
||||
|
||||
1. Ve al Admin UI
|
||||
2. Configura los aliases para tus proyectos:
|
||||
- `socias` → Environment `cmbgr9ipo000ls201jpy12fbi`
|
||||
- `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:
|
||||
|
||||
```bash
|
||||
# 1. Construir nueva imagen
|
||||
docker build -t your-dockerhub-username/formbricks-vanity-server:v1.1.0 .
|
||||
|
||||
# 2. Publicar
|
||||
docker push your-dockerhub-username/formbricks-vanity-server: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:
|
||||
|
||||
```bash
|
||||
# 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
|
||||
Reference in New Issue
Block a user