Cal.com: Sua Agenda Self-Hosted em VPS

O Que é o Cal.com e Por Que Hospedar em um VPS?

O Cal.com é uma solução de agendamento de compromissos de código aberto, projetada para substituir serviços SaaS como o Calendly. Ao optar por uma alternativa self-hosted, você ganha controle total sobre seus dados, personalização e integrações, sem custos de assinatura recorrentes. Hospedar o Cal.com em um VPS (Virtual Private Server) é a escolha ideal para quem busca essa autonomia e segurança, permitindo que você dimensione os recursos conforme sua necessidade. Este guia foca em como implantar o Cal.com de forma eficiente em um ambiente Linux, com o mínimo de complicação.

Veja a infraestrutura: VPS para Cal.com para colocar este projeto no ar.

Para uma operação fluida em produção, recomendamos um plano com no mínimo 4GB de RAM e 4 vCPUs. Isso garante que o Cal.com, juntamente com seu banco de dados PostgreSQL e outros componentes, funcione de maneira estável e responsiva, mesmo sob carga de agendamentos.

Vantagens de Usar Cal.com Self-Hosted

• Controle de Dados: Seus dados de agendamento permanecem em seu servidor, aumentando a privacidade e a segurança.
• Sem Custos de Assinatura: Uma vez configurado, o uso é gratuito, sem mensalidades por usuário ou funcionalidades.
• Personalização Avançada: Adapte a ferramenta à sua marca e fluxo de trabalho com total liberdade.
• Integrações Flexíveis: Conecte o Cal.com a outras ferramentas que você já utiliza, tanto open source quanto proprietárias.

Cal.com vs. Calendly: Uma Comparação Rápida

Enquanto o Calendly oferece uma solução SaaS robusta e fácil de usar, ele vem com custos de assinatura que podem aumentar significativamente com o crescimento da equipe ou do volume de agendamentos. O Cal.com, por outro lado, é uma alternativa gratuita que, com a infraestrutura adequada em um VPS, oferece funcionalidades equivalentes e um nível de controle inatingível em plataformas fechadas.

Implantação do Cal.com em um VPS Linux (Ubuntu)

O método mais recomendado e prático para implantar o Cal.com é utilizando Docker e Docker Compose. Isso garante um ambiente isolado e simplifica a gestão de dependências. Vamos ao passo a passo:

Passo a Passo: Instalação com Docker Compose

1. Pré-requisitos: Servidor Atualizado e Docker Instalado

Certifique-se de que seu servidor Ubuntu está com os pacotes atualizados e que o Docker e Docker Compose estão devidamente instalados. Na Host You Secure, nossos planos já vêm com um ambiente otimizado para aplicações web, mas se você estiver configurando um servidor do zero:

Atualize seus pacotes:

sudo apt update && sudo apt upgrade -y

Instale o Docker e Docker Compose (plugin):

sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

Verifique as instalações:

docker --version
docker compose version

2. Criando o Arquivo `docker-compose.yml`

Crie um diretório para o seu projeto Cal.com e navegue até ele. Dentro deste diretório, crie um arquivo chamado `docker-compose.yml`. Este arquivo definirá os serviços necessários para rodar o Cal.com, incluindo o próprio aplicativo e o banco de dados PostgreSQL.

Crie o diretório e o arquivo:

mkdir caldotcom && cd caldotcom

touch docker-compose.yml

Cole o seguinte conteúdo no seu arquivo `docker-compose.yml`. Ajuste as variáveis de ambiente conforme necessário, especialmente as credenciais do banco de dados.

version: "3.8"

services:
  app:
    image: calcom/cal.com
    container_name: calcom_app
    ports:
      - "3000:3000"
    env_file: .env
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:15
    container_name: calcom_db
    env_file: .env
    volumes:
      - db_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    restart: unless-stopped

volumes:
  db_data:

3. Configurando as Variáveis de Ambiente (`.env`)

No mesmo diretório `caldotcom`, crie um arquivo `.env` e adicione as variáveis de ambiente necessárias para o banco de dados e para o Cal.com. É fundamental definir credenciais seguras aqui.

# Arquivo: .env

# PostgreSQL Configuration
POSTGRES_USER=calcom_user
POSTGRES_PASSWORD=your_strong_db_password
POSTGRES_DB=calcom_db

# Cal.com Application Configuration
DATABASE_URL=postgresql://calcom_user:your_strong_db_password@db:5432/calcom_db

# Você pode adicionar outras variáveis de configuração do Cal.com aqui, como:
# NEXTAUTH_URL=http://localhost:3000
# NEXTAUTH_SECRET=your_very_long_and_secure_secret
# JWT_SIGNIN_KEY=your_long_and_secure_jwt_key
# JWT_VERIFICATION_KEY=your_long_and_secure_jwt_key_verification

# Para produção, é crucial configurar NEXTAUTH_URL e NEXTAUTH_SECRET corretamente.
# Se você for usar um subdomínio (ex: agenda.seusite.com.br), atualize NEXTAUTH_URL para
# https://agenda.seusite.com.br

Importante: Substitua `your_strong_db_password`, `your_very_long_and_secure_secret` e `your_long_and_secure_jwt_key` por senhas e chaves fortes e únicas. Considere gerar chaves de segurança mais robustas para os valores relacionados a `NEXTAUTH_SECRET`, `JWT_SIGNIN_KEY` e `JWT_VERIFICATION_KEY`.

4. Iniciando os Contêineres

Com o `docker-compose.yml` e o `.env` configurados, você pode iniciar os serviços do Cal.com:

docker compose up -d

O comando `docker compose up -d` iniciará os contêineres em segundo plano (`-d`). O Cal.com estará acessível na porta 3000 do seu servidor. Se você estiver usando um firewall no seu VPS, certifique-se de permitir o tráfego na porta 3000.

5. Configurando o Proxy Reverso (Nginx)**

Para acessar o Cal.com de forma segura e profissional (usando HTTPS e um domínio), é essencial configurar um proxy reverso, geralmente com Nginx. Isso permite que você use um domínio personalizado (ex: `agenda.seusite.com.br`) e termine a conexão SSL/TLS no servidor web, encaminhando apenas o tráfego HTTP para o contêiner do Cal.com.

Se você ainda não tem um Nginx configurado com SSL em seu VPS, recomendo seguir este guia detalhado sobre como configurar um proxy reverso com Let's Encrypt. Uma configuração correta de proxy reverso é crucial para a segurança e usabilidade de qualquer aplicação web self-hosted.

Exemplo de configuração básica do Nginx para o Cal.com (substitua `agenda.seusite.com.br` pelo seu domínio):

server {
    listen 80;
    server_name agenda.seusite.com.br;

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl;
    server_name agenda.seusite.com.br;

    ssl_certificate /etc/letsencrypt/live/agenda.seusite.com.br/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/agenda.seusite.com.br/privkey.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Após aplicar a configuração do Nginx, reinicie o serviço:

sudo systemctl restart nginx

Agora, ao acessar `https://agenda.seusite.com.br` em seu navegador, você deverá ver a interface de configuração do Cal.com.

Requisitos de Sistema para Produção

Para garantir a estabilidade e o desempenho do Cal.com em um ambiente de produção, os requisitos de hardware são importantes. A aplicação em si não é extremamente pesada, mas o banco de dados PostgreSQL e a necessidade de ter uma margem para picos de tráfego exigem recursos adequados.

Recursos Mínimos Recomendados

• RAM: 4GB. Isso é o mínimo para que o contêiner do Cal.com e o contêiner do PostgreSQL rodem confortavelmente sem sofrer com falta de memória, especialmente durante a inicialização ou picos de acesso.
• CPU: 4 vCPUs. Um bom número de núcleos de processamento ajuda na rápida execução das requisições e no processamento das operações do banco de dados.
• Armazenamento: 20GB SSD. Espaço suficiente para o sistema operacional, Docker, imagens de contêiner e os dados do banco de dados. SSD é preferível para performance.

Otimizações e Considerações

• Monitoramento: Implemente ferramentas de monitoramento para acompanhar o uso de CPU, RAM e disco. Uma configuração com 4GB de RAM e 4 vCPUs é um ótimo ponto de partida que nossos clientes utilizam com sucesso.
• Atualizações: Mantenha o Docker, Docker Compose e o próprio Cal.com atualizados para garantir segurança e acesso a novos recursos.
• Backup: Configure backups regulares do volume `db_data` para evitar perda de dados em caso de falhas.

Erros Comuns e Soluções

Ao implantar e gerenciar aplicações self-hosted, é comum encontrar alguns obstáculos. Aqui estão alguns problemas frequentes com o Cal.com e como resolvê-los:

• Cal.com não inicia após `docker compose up -d`: Verifique os logs dos contêineres com `docker compose logs app` e `docker compose logs db`. Erros comuns incluem credenciais incorretas no `.env`, problemas de conexão com o banco de dados ou falta de recursos do servidor (RAM insuficiente).
• Falha ao salvar agendamentos: Geralmente, este é um sintoma de problemas de conexão com o banco de dados ou um banco de dados sobrecarregado. Revise as `DATABASE_URL` no `.env` e monitore o uso de recursos do contêiner `db`.
• Problemas de acesso via domínio (após configurar Nginx): Verifique se o Nginx está rodando (`sudo systemctl status nginx`), se as diretivas `server_name` estão corretas, e se as portas 80 e 443 estão abertas no firewall do seu VPS. Certifique-se também de que o proxy_pass está apontando para a porta correta (geralmente 3000).
• Página em branco ou erros de JavaScript no frontend: Pode indicar problemas na compilação ou na comunicação entre o frontend e o backend do Cal.com. Verifique os logs do contêiner `app` e garanta que as variáveis de ambiente `NEXTAUTH_URL` e `NEXTAUTH_SECRET` estão corretamente definidas no arquivo `.env`.

Para aprofundar este tema, consulte também: Directus em VPS: Deploy Rápido e Seguro Metabase Self-Hosted: Instalação Rápida em VPS.

Perguntas Relacionadas

O Cal.com é realmente gratuito?

Sim, o Cal.com é um projeto open source e seu uso como alternativa self-hosted é gratuito. Você não paga por licenças ou assinaturas do software em si. Os custos associados são apenas os da infraestrutura onde ele é hospedado, como o VPS.

Quais são os requisitos mínimos de hardware para o Cal.com?

Para um ambiente de produção estável, recomendamos um mínimo de 4GB de RAM e 4 vCPUs. Isso garante que o Cal.com e seu banco de dados PostgreSQL funcionem de forma confiável, mesmo com um volume considerável de agendamentos.

Posso usar um domínio diferente de `localhost:3000`?

Com certeza. A configuração de um proxy reverso com Nginx é altamente recomendada para usar seu próprio domínio (ex: `agenda.seusite.com.br`) e obter acesso seguro via HTTPS. Isso é padrão para qualquer aplicação web em produção.

O Cal.com suporta integrações com Google Calendar ou Outlook?

Sim, o Cal.com oferece integrações nativas com Google Calendar e Outlook Calendar, permitindo sincronizar seus compromissos de forma bidirecional. Essas integrações são configuradas na interface administrativa do Cal.com após a instalação.

Conclusão: Assuma o Controle da Sua Agenda

Hospedar o Cal.com em seu próprio VPS é um passo estratégico para empresas e profissionais que desejam uma solução de agendamento poderosa, personalizável e econômica. Ao seguir este guia, você estará apto a implantar o Cal.com em poucos minutos, transformando a gestão dos seus compromissos.

A capacidade de controlar seus dados, customizar a experiência do usuário e integrar com suas ferramentas existentes faz do Cal.com uma alternativa self-hosted robusta e inteligente ao Calendly e outros SaaS.

A Recomendação Host You Secure para Cal.com

Para rodar o Cal.com com performance e estabilidade, recomendamos o plano VPS Brasil Básico. Com 4GB de RAM e 4 vCPUs, ele oferece a potência necessária para o Cal.com e seu banco de dados funcionarem sem gargalos. Nossos clientes rodam essa mesma stack em uma VPS Brasil Básico, garantindo agendamentos sem interrupções. Invista na sua autonomia e controle seus agendamentos com:

Conheça o Plano VPS Brasil Básico por R$ 99/mês