Tutoriales de VPS
Reservas propias: laboratorio Cal.diy y límites de Cal.com
Monta un laboratorio personal de Cal.diy con Docker, PostgreSQL y Caddy. Comprende su recomendación fuera de producción y funciones empresariales eliminadas; configura SMTP, OAuth de calendarios, zonas horarias, puertos privados y recuperación probada.

Un sistema de reservas propio permite controlar citas, dominio y correo. También exige mantener PostgreSQL, credenciales OAuth, notificaciones, copias y actualizaciones. Al compararlo con SaaS, incluye alojamiento y licencias de funciones.
Elige primero la edición. A 16 de noviembre de 2026, el repositorio público de Cal.com corresponde a Cal.diy, una versión comunitaria MIT. Sus responsables recomiendan uso personal y no productivo; se han eliminado Teams, Organizations, Insights, Workflows y SSO/SAML empresariales. Aquí tratamos Cal.diy como laboratorio personal. Los requisitos de equipos, turnos y actividad empresarial se aplican solo a una edición que realmente los admita y licencie, como una oferta adecuada de Cal.com.
Ubuntu 24.04, Docker Compose, PostgreSQL y Caddy forman una estructura útil para aprender. Estos presupuestos no avalan Cal.diy para producción:
| Recurso | Laboratorio | Referencia para una edición empresarial soportada |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU o más |
| RAM | 2 GB; compilar puede exigir más | 4 GB o más, con medición |
| Disco | 30 GB SSD | 60 GB SSD o más |
| Sistema | Ubuntu 22.04/24.04 | Ubuntu 24.04 LTS |
| Dominio | cal.example.com | Subdominio de reservas |
Configura A/AAAA válidos y solo administración necesaria y 80/443 públicos en el firewall del proveedor. PostgreSQL queda privado. Revisa free -h, df -h y docker stats si compartes máquina; consulta dimensionamiento.
sudo apt update
sudo apt install -y ca-certificates curl openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/calcom
sudo chown -R "$USER":"$USER" /opt/calcom
cd /opt/calcom
Revisa el instalador ejecutado como root o utiliza el método por paquetes admitido. El grupo Docker también concede acceso potente al anfitrión.
openssl rand -hex 32
openssl rand -base64 32
Los comandos generan material aleatorio, pero cada clave tiene formato. El README actual de Cal.diy indica openssl rand -base64 32 para NEXTAUTH_SECRET y openssl rand -base64 24 para CALENDSO_ENCRYPTION_KEY, que produce los 32 caracteres exigidos por esa configuración. Conserva la clave durante reinicios y recuperación.
Este esquema antiguo usa calcom/cal.com y no es una imagen/plantilla actual verificada de Cal.diy:
services:
db:
image: postgres:16-alpine
restart: unless-stopped
environment:
POSTGRES_DB: calcom
POSTGRES_USER: calcom
POSTGRES_PASSWORD: change-a-long-password
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U calcom -d calcom"]
interval: 10s
timeout: 5s
retries: 10
calcom:
image: calcom/cal.com:latest
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
DATABASE_URL: postgresql://calcom:change-a-long-password@db:5432/calcom
NEXT_PUBLIC_WEBAPP_URL: https://cal.example.com
NEXTAUTH_URL: https://cal.example.com
NEXTAUTH_SECRET: change-another-long-secret
CALENDSO_ENCRYPTION_KEY: change-a-32-byte-key
NODE_ENV: production
ports:
- "127.0.0.1:3000:3000"
volumes:
postgres_data:
Para el laboratorio, sigue las instrucciones Docker comunitarias:
cd /opt/calcom
git clone --recursive https://github.com/calcom/cal.diy.git
cd cal.diy
cp .env.example .env
Revisa y fija una publicación/commit y una etiqueta de imagen correspondiente. La plantilla completa incluye más servicios: conserva nombres de base, hosts, migraciones y credenciales coherentes, reemplazando los valores de ejemplo. Vincula la web a 127.0.0.1:3000:3000 y mantén privadas publicaciones API/Redis. Otro servicio API no debe competir con Caddy por 80.
Evita latest. Guarda secretos en .env protegido o mediante el mecanismo admitido. Configura la URL final antes de compilar: algunas variables NEXT_PUBLIC quedan dentro de la imagen y no cambian solo con variables de ejecución. Sigue los requisitos de base de datos y compilación de tu versión.
Después de revisar la configuración efectiva:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 calcom
Compose config puede imprimir secretos. No publiques su salida ni siembres usuarios de desarrollo en una instancia accesible por internet.
ssh -L 3000:127.0.0.1:3000 root@SERVER_IP
Abre http://127.0.0.1:3000 mediante el túnel para las primeras comprobaciones. Completa login y OAuth en el hostname HTTPS final: una URL temporal HTTP no equivale a él.
NEXT_PUBLIC_WEBAPP_URLcoincide con el dominio final.NEXTAUTH_URLcoincide exactamente con la URL de autenticación documentada.- La clave de cifrado permanece estable.
- El esquema ilustrativo usa
dby nolocalhost; la plantilla oficial puede usar otro nombre de servicio. - DNS del remitente y mensajes de registro/login están preparados y probados.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
cal.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:3000
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://cal.example.com
Usa una sola puerta de entrada en 80/443. Verifica DNS, upstream 3000, host/protocolo reenviados y ajustes del proxy. HSTS/includeSubDomains exige HTTPS en los nombres afectados. Consulta Caddy.
Prepara y verifica:
- Host y puerto SMTP, usuario y credencial de aplicación apropiada.
- Remitente y nombre visible.
- SPF, DKIM y DMARC.
- Confirmación y cancelación de una reserva, incluidos sus enlaces.
Los calendarios externos necesitan una aplicación OAuth con permisos. El siguiente callback es de login Google; no es el único del calendario:
https://cal.example.com/api/auth/callback/google
Las instrucciones actuales añaden /api/integrations/googlecalendar/callback para Google Calendar y /api/integrations/office365calendar/callback para Microsoft. Registra las URL completas en tu dominio HTTPS y configura credenciales en el servidor. Habilitar la API Google, consentimiento, usuarios de prueba y verificación puede condicionar quién conecta.
Protege Client Secrets y las claves que cifran refresh tokens. Prueba conexiones y revocación de cada usuario. Login e integración de calendario son permisos diferentes.
Configura en este orden:
- Identidad, zona horaria y semana laboral.
- Invitaciones de equipo solo en una edición con licencia que las admita; Cal.diy no incluye esos equipos empresariales.
- Eventos de 30 minutos para consultas o 60 minutos para demos.
- Calendarios y reglas de disponibilidad.
- Márgenes, antelación mínima y plazos de cancelación.
- Enlaces públicos deliberados; una URL no listada no equivale a control de acceso.
- Pruebas de visitante: reservar, cambiar, cancelar y comprobar zonas horarias.
La asignación por turnos y flujos de equipo también requieren una edición compatible. Prueba escritorio/móvil y zonas reales, incluidos cambios de horario estacional. La página visible no demuestra detección de conflictos ni envío correcto.
Conserva PostgreSQL, .env, Compose y claves de cifrado/integración:
mkdir -p /opt/calcom/backups
docker compose exec -T db pg_dump -U calcom -d calcom | gzip > /opt/calcom/backups/calcom-$(date +%F).sql.gz
cp .env docker-compose.yml /opt/calcom/backups/
Adapta servicio y usuario reales; db/calcom del esquema pueden diferir. Activa pipefail y verifica la exportación antes de confiar en el comprimido. Guarda configuración activa y volúmenes adicionales necesarios, cifrando copias externas y protegiendo secretos.
Restaura la misma versión en un laboratorio limpio y prueba login, eventos, calendarios y correo. Mantén tareas restauradas desactivadas hasta querer enviar notificaciones reales. Consulta la recuperación probada.
docker compose config > /opt/calcom/backups/compose-$(date +%F).yaml
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 calcom
Recrear contenedores no es un plan completo de migración. Fija imágenes anteriores/nuevas, prueba migraciones y revisa notas de la edición. Evita seguir latest sin copia. Revertir tras migrar puede exigir restaurar base y claves correspondientes.
docker compose ps
docker compose logs --tail=200 calcom
sudo journalctl -u caddy -n 100 --no-pager
ss -lntp | grep -E ':3000|:80|:443'
Verifica 127.0.0.1:3000, disponibilidad del contenedor, upstream y OOM. Dentro del contenedor, la aplicación normalmente debe escuchar en su interfaz, no solo en loopback propio.
Compara URL final, callbacks de login/integración, ruta exacta, hostname, reloj y esquema del proxy. Una IP temporal o túnel HTTP no sustituye un callback HTTPS registrado.
Revisa errores, credenciales/TLS/puerto SMTP, DNS, rebotes y spam. Prueba confirmaciones y cancelaciones por separado. En versiones con web push, claves VAPID ausentes también pueden afectar al arranque; usa las opciones documentadas.
- Diferencia entre laboratorio personal y edición comercial soportada comprendida.
- Dominio, HTTPS, login y reservas completos funcionan.
- SMTP y DNS del remitente verificados.
- Callbacks de calendario/login coinciden con el dominio final.
- PostgreSQL y servicios internos privados.
.env, base y claves con copia externa.- Restauración limpia probada.
- Versiones, migraciones y recuperación documentadas.
En Cal.diy comienza con calendarios y destinatarios de prueba. Para reservas empresariales, elige antes una implantación soportada y las licencias de funciones necesarias.