Easy Appointments na VPS: agenda online do seu negócio
Easy!Appointments 1.6.1: licença GPL, requisitos, instalação na ordem em Ubuntu com Apache e MySQL, e-mail, Google Calendar, cron, HTTPS, backup, atualização e dados dos clientes.
Por Redação Eleven Host · @robson.direitodigital · 11 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Easy Appointments na VPS: agenda online do seu negócio Arte: Eleven Host
Easy Appointments na VPS é a forma de manter no seu próprio servidor o Easy!Appointments, uma agenda online de código aberto em PHP com MySQL. Veja a licença, os requisitos, a instalação na ordem, o Apache, o HTTPS, o backup e a atualização.
Atualizado em 11/11/2026. Na data deste guia, a versão estável mais nova é a 1.6.1, de outubro de 2026. Os blocos marcados como exemplo são montados aqui e não foram executados: confira cada um no seu servidor antes de usar.
O que é o Easy!Appointments e para quem serve
O Easy!Appointments é um sistema de agendamento de código aberto e auto-hospedado, mantido por Alex Tselegidis. O código usa a licença GPL v3.0. Entre os recursos listados no projeto estão agendamentos e clientes, serviços e prestadores, planos de trabalho com regras de reserva, sincronização com o Google Calendar e interface em vários idiomas, incluindo o português do Brasil. O cliente final marca o horário numa página pública, sem criar conta.
Um salão pode cadastrar cada profissional como prestador, e uma clínica, um consultório ou uma oficina pode separar os serviços por duração. São exemplos de uso, e o resultado depende de como cada negócio organiza a agenda. Para entender o que é uma VPS antes de seguir, o guia completo de servidor VPS explica o básico.
Hospedar por conta própria dá controle sobre o banco e os dados, e traz a tarefa de cuidar do servidor, das atualizações e das cópias.
Requisitos oficiais
O README pede Apache ou Nginx, PHP 8.2 ou mais novo e um banco MySQL. O guia de instalação fala em Apache 2.4 ou mais novo. Para o MySQL, o projeto recomenda uma versão atual. As extensões do PHP listadas no composer.json da 1.6.1 são curl, json, mbstring, gd, simplexml e fileinfo. O FAQ do projeto pede para conferir o mod_rewrite do Apache.
Segundo as notas da 1.6.1, o pacote da versão não precisa mais do Composer no servidor. O site oficial avisa que o servidor precisa permitir cron, usado na sincronização de calendário.
Para decidir o tamanho do servidor, o artigo Servidor para sistema de agendamento: o que avaliar lista os pontos a pesar. Dúvidas sobre a VPS vão ao atendimento da Eleven Host, em português do Brasil, pela área do cliente e por tickets.
Escolhido o servidor, a loja da Eleven Host mostra as VPS. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instalação pelo pacote oficial, na ordem
O caminho oficial é este: banco criado, arquivos enviados, pasta storage gravável, config.php preenchido e, só então, o assistente no navegador.
Primeiro, os pacotes, como administrador do servidor (o sudo dos comandos). Um exemplo de comando para Ubuntu:
sudo apt install apache2 mysql-server php php-curl php-mbstring php-gd php-xml php-mysql unzip
Antes de seguir, confira a versão do PHP, que precisa ser 8.2 ou mais nova, e o mod_rewrite. Um exemplo de comando:
php -v
sudo a2enmod rewrite
sudo systemctl restart apache2
Se o php -v mostrar uma versão mais antiga, o Ubuntu escolhido não serve para a 1.6.1 sem outro repositório. Passo 1, o banco, anotando nome, usuário e senha. Os comandos SQL vão dentro do prompt do MySQL, aberto pelo administrador com o primeiro comando. Um exemplo, com senha fictícia que você deve trocar:
sudo mysql
CREATE DATABASE easyappointments CHARACTER SET utf8mb4;
CREATE USER 'agenda'@'localhost' IDENTIFIED BY 'troque-esta-senha';
GRANT ALL PRIVILEGES ON easyappointments.* TO 'agenda'@'localhost';
EXIT;
Passo 2: baixe o pacote da 1.6.1 na página de releases do projeto no GitHub e envie para o servidor. O nome exato do arquivo pode variar, então ajuste o comando ao que você baixou. Um exemplo, com o arquivo já na pasta atual:
sudo unzip easyappointments.zip -d /var/www/html/
A pasta resultante deve se chamar easyappointments; se vier com outro nome, renomeie ou use o nome real nos próximos comandos. Passo 3: a pasta storage precisa ser gravável. O guia do projeto dá chmod -R 755 storage. Com o Apache rodando como www-data, esse modo só serve se o dono da pasta for esse usuário. Um exemplo de comando:
cd /var/www/html/easyappointments
sudo chown -R www-data:www-data storage
Passo 4: renomeie o config-sample.php para config.php e edite os valores. Um exemplo:
sudo mv config-sample.php config.php
sudo nano config.php
BASE_URL: o endereço da instalação, sem a barra no final, comohttps://seu-dominio.com.br/easyappointments. Num subdomínio, é a URL dele. O domínio já precisa apontar para a VPS e ter o certificado (seção do HTTPS).DB_HOST: o arquivo de exemplo trazmysql, pensado para Docker. Num servidor comum, o guia diz que geralmente élocalhost.DB_NAME,DB_USERNAMEeDB_PASSWORD: os dados do banco criado acima.LANGUAGE: o exemplo trazenglish; a pasta de idiomas da 1.6.1 incluiportuguese-br.DEBUG_MODE: deixe emfalse.
Passo 5: ajuste o Apache e o HTTPS, nas duas seções seguintes, e só então abra a URL no navegador. O assistente pede a conta do administrador e os dados da empresa; clique em Install. Como alternativa ao assistente, na pasta do sistema e com o config.php preenchido, a documentação traz php index.php console install. O exemplo roda como o usuário do Apache, para o storage não ficar com dono root:
sudo -u www-data php index.php console install
Depois da instalação, entre em /index.php/calendar. Em Settings, Business Logic, defina os dias e horários padrão dos novos prestadores. Cadastre os serviços e os prestadores em Users, Providers. A página pública aparece em Go To Booking Page.
Apache, mod_rewrite e o caso do Nginx
O Apache 2.4 com mod_rewrite é o caminho com documentação oficial. O FAQ do projeto manda conferir o mod_rewrite e diz que alguns servidores precisam de regra de rewrite no .htaccess. Para o .htaccess valer, o Apache pode precisar de AllowOverride All na pasta do sistema. Um exemplo, no arquivo /etc/apache2/sites-available/000-default.conf, dentro do <VirtualHost *:80> (o ServerName também serve ao Certbot, mais abaixo):
ServerName seu-dominio.com.br
<Directory /var/www/html/easyappointments>
AllowOverride All
</Directory>
Depois, rode sudo systemctl reload apache2 e confira no seu servidor. Confira também se o pacote que você baixou traz o .htaccess.
O Nginx aparece como alternativa no README, mas o projeto não publica um bloco de configuração para ele. Quem escolher esse caminho monta a configuração por conta própria e testa. Se houver um proxy reverso à frente do sistema, como Nginx, Caddy, Traefik ou Cloudflare, o guia manda definir a variável de ambiente PROXY_IPS com o endereço do proxy. Sem isso, os visitantes parecem um só cliente para o limitador de tentativas.
E-mail, Google Calendar e cron
As notificações documentadas são de confirmação, alteração e cancelamento, para cliente, prestador, secretárias e administradores. Lembretes automáticos antes do horário não estão entre as notificações documentadas; o site os apresenta como desenvolvimento sob medida. O servidor precisa estar configurado para enviar e-mail. O arquivo application/config/email.php traz o protocolo (mail ou smtp) e, comentadas, as chaves do SMTP, como servidor, usuário, senha, criptografia e porta.
Numa atualização esse arquivo é substituído junto com os demais; recomendamos anotar os valores para refazer.
Para o Google Calendar, a documentação pede um projeto no Google Cloud com a Google Calendar API ativada e um cliente OAuth do tipo aplicação web. O endereço da instalação entra nas origens JavaScript autorizadas, e o endereço de retorno segue o modelo https://seu-dominio.com.br/easyappointments/index.php/google/oauth_callback, trocando pelo seu. As credenciais vão em Settings, Integrations, Google Calendar, ou no config.php. A sincronização vale nos dois sentidos, e cada prestador liga a sua conta pelo botão Enable Sync no Calendário.
Um exemplo de cron, com os caminhos fictícios da instalação acima: a primeira linha sincroniza de hora em hora e a segunda faz a limpeza (cleanup) às 3h30, que aplica a retenção de dados. O administrador abre a tabela do usuário do Apache com sudo crontab -u www-data -e e cola as duas linhas, para o storage manter o dono certo:
0 * * * * cd /var/www/html/easyappointments && php index.php console sync
30 3 * * * cd /var/www/html/easyappointments && php index.php console cleanup
HTTPS no domínio da agenda
O certificado fica por conta de quem instala: a documentação da API REST recomenda HTTPS em produção. Como a agenda recebe dados de clientes, vale colocar o certificado antes de divulgar a página pública. Como o assistente do Passo 5 cria a senha do administrador, esta seção vem antes dele.
Antes, aponte o DNS do domínio para o IP da VPS. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente. O Certbot com o plugin do Apache procura o VirtualHost com o ServerName do domínio, como no exemplo da seção anterior. Um exemplo de comando, rodado pelo administrador, com o domínio fictício:
sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d seu-dominio.com.br
Se a instalação já estava em http://, troque o BASE_URL do config.php para https://.
Atualização e backup oficiais
O guia de atualização é direto: faça backup do banco e dos arquivos antes de atualizar; os comandos de backup do console estão mais abaixo. Depois, baixe a versão nova e substitua os arquivos, mantendo o seu config.php e copiando antes os arquivos personalizados. Recomendamos preservar também a pasta storage, onde ficam logs e backups, e conferir depois que o dono dela continua www-data. A migração do banco roda pelo navegador, em /index.php/backend/update, ou no terminal, na pasta do sistema, como o usuário do Apache:
sudo -u www-data php index.php console migrate
Se aparecer erro 500 depois de atualizar, os logs ficam em storage/logs.
O backup oficial do console grava em storage/backups, ou numa pasta que você indicar. Um exemplo de comando, na pasta do sistema, como o usuário do Apache; a pasta fictícia da segunda linha precisa existir e pertencer a esse usuário:
sudo -u www-data php index.php console backup
sudo -u www-data php index.php console backup /var/backups/agenda
Uma cópia que fica só no mesmo servidor some junto com ele. O artigo Backup da VPS: como fazer cópia automática mostra como levar as cópias para outro lugar.
Docker: só como alternativa
O docker compose do repositório principal é só para desenvolvimento, e a documentação diz para não usá-lo em produção. Para produção, o projeto indica o repositório separado easyappointments-docker. O exemplo dele usa DEBUG_MODE=TRUE e o usuário root do MySQL: não copie esses dois pontos para um servidor de verdade.
Dados pessoais dos clientes
Uma agenda guarda nome, contato e horários de pessoas, e em clínica e consultório o próprio serviço marcado pode indicar algo sensível. Nas configurações, o sistema permite aviso de cookies, termos e política de privacidade aceitos ao agendar, retenção de dados por número de dias e a opção Delete Personal Info, para o cliente remover seus dados. A retenção só roda com php index.php console cleanup agendado no cron.
A LGPD é a lei brasileira de proteção de dados. A documentação do projeto fala de GDPR, e os selos do site são material de divulgação. Uma ferramenta não garante conformidade sozinha: recomendamos tratar o assunto com quem cuida do jurídico do negócio.
Dimensionar a VPS da agenda
Com os requisitos de software anotados, o passo seguinte é comparar os planos de servidor e escolher um.
Comparar os planos fica a um clique, na loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
O Easy!Appointments é gratuito?
O código é GPL v3.0 e pode ser auto-hospedado sem custo de licença. O servidor, o e-mail e a manutenção ficam com quem hospeda.
Ele manda lembrete automático ao cliente?
Não como recurso documentado. As notificações são de confirmação, alteração e cancelamento; lembretes aparecem no site como desenvolvimento sob medida.
Posso usar MariaDB?
A documentação fala em MySQL e não cita o MariaDB. Se for testar, trate como não oficial.