Documentación de Pronto
Todo lo que necesitas para instalar, configurar y ejecutar Pronto en tu propio servidor.
Inicio rápido
Clonar el repositorio
Clona el repositorio público y copia el archivo de entorno:
git clone https://github.com/SGrappelli/pronto.git
cd pronto
cp .env.example .envConfigurar el entorno
Abre .env y completa las variables requeridas. Mínimo necesario: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY. Consulta la referencia completa de variables más abajo.
Iniciar la aplicación
Ejecuta el siguiente comando. Las migraciones se ejecutan automáticamente al iniciar:
docker compose up -dTu instancia estará disponible en http://localhost:3000
Requisitos del sistema
| Requisito | Mínimo |
|---|---|
| Sistema operativo | Linux, macOS o Windows (WSL2) |
| RAM | 1 GB mínimo, 2 GB recomendado |
| Disco | 5 GB de espacio libre |
| Docker | Docker 24+ con Docker Compose v2 |
| Internet | Necesario para configuración inicial y notificaciones |
| Dominio (opcional) | Cualquier dominio o subdominio apuntando a tu servidor |
Variables de entorno
Copia .env.example a .env y completa los valores indicados.
| Variable | Requerida | Descripción |
|---|---|---|
NEXT_PUBLIC_SUPABASE_URL | ✅ | URL de tu proyecto Supabase |
NEXT_PUBLIC_SUPABASE_ANON_KEY | ✅ | Clave anónima de Supabase |
SUPABASE_SERVICE_ROLE_KEY | ✅ | Clave de rol de servicio (mantener en secreto) |
NEXTAUTH_SECRET | ✅ | Cadena aleatoria para cifrado de sesión |
NEXTAUTH_URL | ✅ | URL completa de tu instancia (ej. https://tudominio.com) |
NEXT_PUBLIC_DEPLOYMENT_MODE | ✅ | Establecer como: selfhosted |
RESEND_API_KEY | ⚡ | Clave API de Resend para notificaciones por email |
TELEGRAM_BOT_TOKEN | ⚡ | Token del bot de Telegram de @BotFather |
WHATSAPP_PHONE_NUMBER_ID | ⚡ | ID de número de teléfono de Meta Cloud API |
WHATSAPP_ACCESS_TOKEN | ⚡ | Token de acceso permanente de Meta Cloud API |
VIBER_BOT_TOKEN | ⚡ | Token del bot de Viber |
NEXT_PUBLIC_DEPLOYMENT_MODE=selfhosted elimina toda la interfaz de facturación SaaS y habilita clientes, empleados y ubicaciones ilimitados.
Configuración de notificaciones
Email (Resend)+
- 1.Crea una cuenta gratuita en resend.com
- 2.Añade y verifica tu dominio
- 3.Genera una clave API
- 4.Establece RESEND_API_KEY en tu archivo .env
- 5.Reinicia: docker compose restart app
Telegram+
- 1.Abre Telegram y escribe a @BotFather
- 2.Envía /newbot y sigue las instrucciones
- 3.Copia el token que recibes
- 4.Establece TELEGRAM_BOT_TOKEN en tu archivo .env
- 5.En Pronto → Configuración → Notificaciones, introduce el token del bot por negocio
WhatsApp (Meta Cloud API)+
- 1.Ve a developers.facebook.com y crea una aplicación
- 2.Añade el producto WhatsApp a tu app
- 3.Copia tu Phone Number ID y genera un token de acceso permanente
- 4.Establece WHATSAPP_PHONE_NUMBER_ID y WHATSAPP_ACCESS_TOKEN en .env
- 5.Nota: los mensajes de texto libre solo funcionan dentro de la ventana de atención al cliente de 24 horas. Los mensajes iniciados por el negocio requieren plantillas HSM aprobadas en Meta Business Manager.
Viber+
- 1.Ve a partners.viber.com y crea un bot
- 2.Copia el token del bot
- 3.Establece VIBER_BOT_TOKEN en tu archivo .env
- 4.Nota: los bots de Viber creados después de febrero de 2024 requieren un plan comercial (~€100/mes).
Actualizar a una nueva versión
git pull origin main
docker compose down
docker compose up -d --buildLas migraciones se ejecutan automáticamente al iniciar — no se requieren pasos SQL manuales.
Preguntas frecuentes
¿Cuáles son los requisitos mínimos del servidor para ejecutar Pronto?+
Pronto requiere Docker 24+, 1 GB de RAM mínimo (2 GB recomendado) y 5 GB de espacio libre en disco. Funciona en Linux, macOS o Windows con WSL2. Un VPS de $6/mes es suficiente para la mayoría de pequeños negocios.
¿Necesito una cuenta de Supabase para alojar Pronto?+
Sí. Pronto usa Supabase para la base de datos y la autenticación. Puedes usar el nivel gratuito de Supabase, que admite hasta 500 MB de almacenamiento de base de datos, más que suficiente para la mayoría de implementaciones de pequeños negocios.
¿Cómo activo las notificaciones de WhatsApp?+
Pronto usa la Meta Cloud API para WhatsApp. Necesitas una cuenta de Meta Developer y un número de WhatsApp Business verificado. Establece WHATSAPP_PHONE_NUMBER_ID y WHATSAPP_ACCESS_TOKEN en tu archivo .env. Los mensajes iniciados por el negocio requieren plantillas de mensajes aprobadas previamente.
¿Puedo ejecutar Pronto sin un nombre de dominio?+
Sí. Pronto funciona con una dirección IP simple o localhost para uso local. Para producción con SSL, se recomienda un nombre de dominio. Puedes usar cualquier proxy inverso (Nginx, Caddy) para añadir HTTPS.
¿Cómo actualizo Pronto a una nueva versión?+
Ejecuta git pull origin main, luego docker compose down && docker compose up -d --build. Las migraciones de base de datos se ejecutan automáticamente al iniciar — no se necesitan pasos SQL manuales.
¿Hay límite de clientes o empleados en la versión self-hosted?+
No. La versión self-hosted es completamente ilimitada — sin límites de clientes, empleados, ubicaciones ni reservas. Establece NEXT_PUBLIC_DEPLOYMENT_MODE=selfhosted en tu .env para activar este modo.
¿Dónde puedo obtener ayuda si algo no funciona?+
Abre un issue en el repositorio de GitHub en github.com/SGrappelli/pronto. La comunidad y los mantenedores responden a los issues allí. Para asistencia de instalación de pago, contacta a través de la página de GitHub.
¿Prefieres una versión administrada?
¿No quieres gestionar un servidor? Pronto también está disponible como servicio en la nube en trypronto.app — sin instalación.