Base de Conhecimento

Easy Appointments na VPS: agenda online do seu negócio

  • easy appointments, agendamento online, agenda online, php, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Easy Appointments na VPS: agenda online do seu negócio

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, como https://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 traz mysql, pensado para Docker. Num servidor comum, o guia diz que geralmente é localhost.
  • DB_NAME, DB_USERNAME e DB_PASSWORD: os dados do banco criado acima.
  • LANGUAGE: o exemplo traz english; a pasta de idiomas da 1.6.1 inclui portuguese-br.
  • DEBUG_MODE: deixe em false.

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.

Esta resposta lhe foi útil?

Artigos Relacionados