Tutoriais de VPS
Agendamento próprio: laboratório Cal.diy e limites do Cal.com
Monte um laboratório pessoal Cal.diy com Docker, PostgreSQL e Caddy. Entenda a recomendação fora de produção e os recursos empresariais removidos; configure SMTP, OAuth de calendários, fusos, portas privadas e recuperação testada.

Um sistema próprio de agendamento permite controlar compromissos, domínio e e-mail. Você também precisa manter PostgreSQL, credenciais OAuth, notificações, backups e atualizações. Compare custos de hospedagem e licenças de recursos ao avaliar uma alternativa ao SaaS.
Escolha a edição primeiro. Em 16 de novembro de 2026, o repositório público de Cal.com corresponde ao Cal.diy, uma versão comunitária MIT. Os mantenedores recomendam uso pessoal, fora de produção; Teams, Organizations, Insights, Workflows e SSO/SAML empresariais foram removidos. Este guia trata Cal.diy como laboratório pessoal. Requisitos de equipes, distribuição de atendimentos e uso comercial se aplicam somente a uma edição que os suporte e licencie, como uma oferta adequada do Cal.com.
Ubuntu 24.04, Docker Compose, PostgreSQL e Caddy formam uma estrutura útil para aprender. Os orçamentos abaixo não recomendam Cal.diy para produção:
| Recurso | Laboratório | Referência de capacidade para edição comercial suportada |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU ou mais |
| RAM | 2 GB; compilar pode exigir mais | 4 GB ou mais, com medição |
| Disco | 30 GB SSD | 60 GB SSD ou mais |
| Sistema | Ubuntu 22.04/24.04 | Ubuntu 24.04 LTS |
| Domínio | cal.example.com | Subdomínio de agendamento |
Configure A/AAAA válidos e somente administração necessária e 80/443 públicos no firewall do provedor. PostgreSQL permanece privado. Confira free -h, df -h e docker stats se compartilhar a VPS; veja dimensionamento.
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
Revise o instalador executado como root ou use a instalação por pacotes suportada. O grupo Docker também concede acesso poderoso ao anfitrião.
openssl rand -hex 32
openssl rand -base64 32
Esses comandos geram material aleatório, mas as chaves têm formatos específicos. O README atual indica openssl rand -base64 32 para NEXTAUTH_SECRET e openssl rand -base64 24 para CALENDSO_ENCRYPTION_KEY, produzindo os 32 caracteres exigidos nessa configuração. Preserve a chave em reinícios e restaurações.
O esboço antigo usa calcom/cal.com e não é uma imagem/modelo atual verificado do 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 o laboratório, siga as instruções Docker da comunidade:
cd /opt/calcom
git clone --recursive https://github.com/calcom/cal.diy.git
cd cal.diy
cp .env.example .env
Revise e fixe uma versão/commit e tag de imagem correspondente. O modelo completo inclui mais serviços: mantenha banco, hosts, migrações e credenciais coerentes, substituindo todos os valores de exemplo. Publique a web em 127.0.0.1:3000:3000 e torne privadas as publicações de API/Redis. Outro serviço API não deve competir com Caddy pela porta 80.
Evite latest. Guarde segredos no .env protegido ou no mecanismo suportado. Configure a URL final antes de compilar: variáveis NEXT_PUBLIC podem ficar incorporadas à imagem e não mudar somente com o ambiente de execução. Siga os requisitos de banco e compilação da versão.
Depois de revisar a configuração efetiva:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 calcom
Compose config pode imprimir segredos. Não publique a saída nem crie usuários de desenvolvimento em uma instância acessível pela internet.
ssh -L 3000:127.0.0.1:3000 root@SERVER_IP
Abra http://127.0.0.1:3000 pelo túnel para verificações iniciais. Conclua login e OAuth no hostname HTTPS final; um endereço HTTP temporário não é equivalente.
NEXT_PUBLIC_WEBAPP_URLcorresponde ao domínio público final.NEXTAUTH_URLcorresponde exatamente à URL de autenticação documentada.- A chave de criptografia permanece estável.
- O esboço usa
db, nãolocalhost; use o nome real do serviço no modelo escolhido. - DNS do remetente e mensagens de registro/login estão preparados e testados.
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
Use um único gateway público em 80/443. Confira DNS, upstream 3000, host/protocolo encaminhados e ajustes do proxy. HSTS/includeSubDomains exige HTTPS nos nomes afetados. Veja Caddy e proxy.
Prepare e teste:
- Host/porta SMTP, usuário e credencial de aplicação apropriada.
- Remetente e nome exibido.
- SPF, DKIM e DMARC.
- Confirmação e cancelamento de agendamento, incluindo os links.
Calendários externos precisam de aplicação OAuth e permissões. O callback abaixo é de login Google, não o único do calendário:
https://cal.example.com/api/auth/callback/google
As instruções atuais também especificam /api/integrations/googlecalendar/callback para Google Calendar e /api/integrations/office365calendar/callback para Microsoft. Registre URLs completas no domínio HTTPS final e configure credenciais no servidor. API Google habilitada, consentimento, usuários de teste e verificação podem limitar quem consegue conectar.
Proteja Client Secrets e chaves que criptografam refresh tokens. Teste conexão e revogação de cada usuário separadamente. Login e acesso ao calendário são permissões diferentes.
Configure nesta ordem:
- Identidade, fuso horário e semana de trabalho.
- Convites de equipe somente em edição licenciada que os suporte; Cal.diy não inclui essas equipes empresariais.
- Eventos de 30 minutos para consultas ou 60 minutos para demonstrações.
- Calendários e regras de disponibilidade.
- Intervalos de folga, antecedência mínima e prazo de cancelamento.
- Links públicos definidos conscientemente; uma URL não listada não autentica visitantes.
- Testes de visitante para agendar, remarcar, cancelar e conferir fusos.
Distribuição por rodízio e fluxos de equipe também exigem edição compatível. Teste computador/celular e fusos reais, incluindo mudanças de horário de verão. A página abrir não comprova detecção de conflitos nem entrega de e-mail.
Guarde PostgreSQL, .env, Compose e chaves persistentes de criptografia/integração:
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/
Adapte serviço e usuário reais; db/calcom podem diferir no modelo oficial. Use pipefail e confira a exportação antes de confiar no arquivo comprimido. Salve configuração ativa e volumes adicionais necessários, criptografando cópias externas e protegendo os segredos.
Restaure a mesma versão em laboratório limpo e confira login, eventos, calendários e e-mails. Mantenha tarefas restauradas desativadas até pretender enviar notificações reais. Veja o teste de recuperação.
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
Recriar contêineres não é um plano completo de migração. Fixe imagens antigas/novas, teste migrações e leia notas da edição. Evite seguir latest sem backup. Reverter após migrar pode exigir restaurar banco e chaves correspondentes.
docker compose ps
docker compose logs --tail=200 calcom
sudo journalctl -u caddy -n 100 --no-pager
ss -lntp | grep -E ':3000|:80|:443'
Confira 127.0.0.1:3000, prontidão do contêiner, upstream do Caddy e OOM. Dentro do contêiner, a aplicação normalmente precisa escutar em sua interface, não apenas no próprio loopback.
Compare URL final, callbacks de login/integração, caminho exato, hostname, relógio e esquema do proxy. IP temporário ou túnel HTTP não substitui o callback HTTPS registrado.
Confira erros da aplicação, credenciais/TLS/porta SMTP, DNS, devoluções e spam. Teste confirmações e cancelamentos separadamente. Em versões com web push, chaves VAPID ausentes também podem afetar a inicialização; use os ajustes documentados.
- Limite entre laboratório pessoal e edição comercial suportada compreendido.
- Domínio, HTTPS, login e fluxo completo de agendamento funcionando.
- SMTP e DNS do remetente verificados.
- Callbacks de calendário/login no domínio final.
- PostgreSQL e serviços internos privados.
.env, banco e chaves com cópias externas.- Restauração limpa testada.
- Versões, migrações e recuperação documentadas.
No Cal.diy, comece com calendários e destinatários de teste. Para agendamento comercial, escolha uma implantação suportada e as licenças necessárias antes de depender dela para compromissos reais.