FreeScout na VPS: atendimento por e-mail da equipe
FreeScout 1.8.250: licença AGPL-3.0, alertas de segurança, instalação com Nginx, PHP e MariaDB, HTTPS, caixa de e-mail, cron, anexos, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: FreeScout na VPS: atendimento por e-mail da equipe Arte: Eleven Host
FreeScout na VPS é um jeito de montar a caixa de e-mail compartilhada da equipe de atendimento num servidor seu. Veja a licença, a versão, a instalação com Nginx, PHP e MariaDB, o HTTPS, a caixa de e-mail, o backup e a atualização.
Atualizado em 13/11/2026. Os blocos de comandos e de configuração abaixo são exemplos: confira cada um no seu servidor antes de usar.
O que é o FreeScout e qual é a licença
O FreeScout é um sistema de atendimento hospedado por conta própria, que funciona como caixa de entrada compartilhada. As mensagens viram conversas que a equipe pode marcar com estrela, seguir, encaminhar, mesclar e mover. Há notas internas, e um aviso aparece quando dois atendentes abrem a mesma conversa. O projeto também tem API, webhooks e relatórios.
O FreeScout é código aberto sob a licença AGPL-3.0. Na data de hoje, a versão estável é a 1.8.250, de 07/11/2026. Houve vários alertas de segurança graves em outubro de 2026, e recomendamos usar essa versão ou uma mais nova e atualizar com frequência.
O núcleo não limita atendentes, conversas nem caixas de e-mail. A maior parte dos módulos extras é paga, como respostas prontas, workflows, base de conhecimento e tags, com licença vitalícia por instância e sem reembolso, segundo o site do projeto. Os preços ficam com o fabricante. Ao ativar um módulo oficial, o nome de domínio da instalação é enviado ao freescout.net para registrar a licença do módulo.
Para quem serve
São exemplos de uso: uma equipe pequena que divide a caixa de suporte entre várias pessoas, ou uma empresa que prefere guardar as conversas com clientes num servidor sob o seu controle. Para quem ainda não tem servidor, o guia completo de servidor VPS explica o que é uma VPS.
Versão e segurança
Em 31/10/2026, o projeto publicou alertas de gravidade alta. Um deles permitia que um remetente externo, com um Message-ID forjado numa resposta a notificação, postasse e enviasse e-mail como se fosse um atendente. Esse foi corrigido na 1.8.249.
A 1.8.250 revoga as sessões web quando a senha é redefinida. A lista de alertas do projeto tem outros itens, sem confirmação de que cada um esteja corrigido. Por isso, depois de instalar, confira a versão em Manage, System, Status e mantenha as atualizações em dia.
Antes de começar
Não existe imagem Docker oficial: a página de Docker do site leva a um projeto de terceiros. O guia de instalação do projeto usa Nginx, PHP e MySQL ou MariaDB, e é esse o caminho mostrado abaixo. O mesmo guia pede PHP 8.2 ou mais novo e manda evitar o PHP 8.1, por causa de falhas na leitura de XML e HTML. O HTTPS é necessário para as notificações push no navegador.
Tenha à mão uma caixa de e-mail dedicada ao suporte, com acesso IMAP e SMTP, e um endereço como atendimento.exemplo.com apontando para o IP da VPS.
A mensalidade de cada VPS aparece 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. Ver as VPS
Instalação por script, só em VPS nova
Aviso antes de rodar o install.sh
O script oficial, para Ubuntu e Debian, é feito para um servidor limpo. Ele remove o Apache, apaga o conteúdo da pasta de instalação e executa DROP DATABASE IF EXISTS no banco freescout. Não rode numa VPS que já tenha outros sites.
Numa VPS nova, o guia oficial indica estes comandos. O script pergunta o domínio, a pasta (a padrão é /var/www/html) e se deve ativar o HTTPS, e pede o DNS apontado antes. No fim, mostra o endereço /install e a senha do banco que ele gerou:
sudo apt install wget
wget https://raw.githubusercontent.com/freescout-help-desk/freescout/dist/tools/install.sh
chmod u+x install.sh
sudo ./install.sh
O caminho manual abaixo também remove o Apache e usa a pasta /var/www/html: com outros sites no servidor, confira antes o que já está em uso.
Instalação manual, na ordem do guia
Primeiro, os pacotes. Os exemplos do guia usam php8.5; troque pelo número da versão que a sua distribuição oferece, desde que seja 8.2 ou mais nova, e use o mesmo número no socket do Nginx mais adiante. Inclua também o php-imap, que o script e a seção de problemas do guia pedem (se o apt não achar o pacote para a sua versão do PHP, veja a seção de problemas do guia), e confira depois:
sudo apt-get update
O guia remove o Apache com o comando abaixo; se algum site da VPS usa o Apache, não rode este comando:
sudo apt remove apache2
sudo apt install nginx git
sudo apt install php8.5-fpm php8.5 php8.5-mysql php8.5-mbstring php8.5-xml php8.5-zip php8.5-gd php8.5-curl php8.5-intl
sudo apt install php-imap
sudo apt install mariadb-server mariadb-client
php -v
php -m
Segundo, o banco. Abra o cliente com mysql -u root -p e troque XXX por uma senha forte. Se o GRANT com IDENTIFIED BY falhar, o guia traz a alternativa com CREATE USER:
CREATE DATABASE `freescout` CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON `freescout`.* TO `freescout`@`localhost` IDENTIFIED BY "XXX";
Terceiro, o código, numa pasta vazia (o rm abaixo tira a página padrão do Nginx), e o dono www-data para tudo o que está nela. O clone traz o ramo dist, que já inclui as dependências do Composer. Para que o seu usuário de SSH também escreva na pasta, o guia coloca o grupo primário dele como www-data; troque SEU_USUARIO pelo nome real:
sudo mkdir -p /var/www/html
sudo chown www-data:www-data /var/www/html
cd /var/www/html
sudo rm /var/www/html/*nginx*.html
sudo git clone https://github.com/freescout-help-desk/freescout .
sudo chown -R www-data:www-data /var/www/html
sudo usermod -g www-data SEU_USUARIO
sudo find /var/www/html -type f -exec chmod 664 {} \;
sudo find /var/www/html -type d -exec chmod 775 {} \;
Quarto, o Nginx. Pelo guia, copie o arquivo default de /etc/nginx/sites-available para um arquivo com o nome do seu endereço, remova o link default de sites-enabled e crie o link do arquivo novo. A configuração completa é longa, por isso copie a do guia oficial e ajuste estes pontos: server_name com o seu endereço, root /var/www/html/public;, fastcgi_pass com o socket da sua versão do PHP-FPM, como unix:/run/php/php8.5-fpm.sock;, e client_max_body_size para os anexos. Depois de ativar o site, teste e reinicie:
sudo nginx -t
sudo service nginx restart
sudo service php8.5-fpm restart
HTTPS antes do instalador web
Recomendamos emitir o certificado antes de abrir o /install, para que a senha do administrador não passe por HTTP. O Certbot precisa do DNS apontado e do Nginx respondendo. O artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx detalha o processo; o guia do FreeScout usa estes comandos, com a opção de redirecionar tudo para HTTPS:
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
sudo certbot --nginx
sudo certbot renew --dry-run
Para domínios registrados conosco, há DNS gerenciado grátis na rede da Cloudflare, com painel na área do cliente.
Instalador web e cron
Abra https://atendimento.exemplo.com/install. O instalador confere extensões e permissões, pergunta o banco, o fuso e cria o administrador. Não crie o arquivo .env à mão antes: se ele existir, o instalador web não roda. O comando abaixo repete a verificação pela linha de comando:
sudo -u www-data php /var/www/html/artisan freescout:check-requirements
Depois vem o cron, que é obrigatório: a busca de e-mails, a fila e as notificações dependem dele. Abra o crontab do usuário www-data, e não o do root, porque artisan ou cron rodando como root deixam o cache com dono errado e quebram o sistema:
sudo crontab -u www-data -e
* * * * * php /var/www/html/artisan schedule:run >> /dev/null 2>&1
Caixa de e-mail e envio
No painel, as configurações de conexão da caixa têm uma parte para enviar e outra para buscar. A busca em segundo plano pega só as mensagens não lidas e as marca como lidas. Por isso a caixa deve ser usada só pelo FreeScout, e sem encaminhamento, regra de roteamento ou resposta automática, que podem gerar um laço de mensagens.
Para buscar, o FreeScout aceita IMAP ou POP3, e o POP3 pode atrasar a busca. Um exemplo da documentação é imap.gmail.com na porta 993 com SSL. No Gmail, a busca por OAuth não é possível: use uma senha de app, digitada sem espaços. Para enviar, dá para usar o mail() do servidor, um SMTP próprio ou um serviço de envio. Provedores gratuitos, como o Gmail, têm limite diário de mensagens, e o artigo E-mail do domínio não recebe mensagens: o que fazer ajuda se o domínio não receber.
Anexos
O limite de anexo envolve cinco pontos, que convém ajustar juntos: upload_max_filesize, post_max_size e memory_limit no php.ini, client_max_body_size no Nginx e o campo Max. Message Size do painel.
Backup e atualização
São duas partes: a pasta da aplicação, com configurações e módulos, e um export do banco. Guarde o .env junto, e não troque o APP_KEY dele, porque esse valor criptografa as senhas das caixas de e-mail. Um exemplo de cópia, a conferir no seu servidor (acrescente -u e -p ao mysqldump se o banco pedir usuário e senha):
mysqldump --single-transaction freescout > ~/freescout.sql
sudo tar czf ~/freescout-arquivos.tar.gz /var/www/html
Recomendamos guardar as cópias fora da VPS; o artigo Backup da VPS: como fazer cópia automática mostra como fazer isso.
Para atualizar, faça o backup antes. O script de atualização roda como www-data. Se o número da versão não mudar, a atualização não terminou.
sudo -u www-data /var/www/html/tools/update.sh
Dados dos clientes e LGPD
As conversas guardam nomes, e-mails e o conteúdo do que os clientes escrevem, que pode incluir dados pessoais. A LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação, e um software não garante conformidade sozinho. Recomendamos limitar quem tem conta de atendente, manter o HTTPS ligado e levar o assunto ao jurídico da empresa.
Servidor e endereço do atendimento
Com o atendimento no ar, o endereço de acesso continua dependendo do DNS do domínio, que precisa apontar para o IP da VPS.
O exemplo atendimento.exemplo.com parte do domínio exemplo.com, e a Eleven Host registra domínios em centenas de extensões. Buscar domínio
Perguntas frequentes
O FreeScout é gratuito?
O núcleo é código aberto, sob a licença AGPL-3.0, e dá para hospedar por conta própria. Os módulos pagos, como respostas prontas, workflows, base de conhecimento e tags, têm preço definido pelo fabricante.
Qual versão usar na data de hoje?
A 1.8.250, de 07/11/2026, ou uma mais nova. Houve vários alertas de segurança graves em outubro de 2026, e recomendamos atualizar com frequência.
Por que o e-mail não chega ao FreeScout?
Confira se o cron do www-data está ativo, se a caixa é só do FreeScout, sem encaminhamento nem resposta automática, e use o botão Fetch Emails com Debug. No Gmail, a busca exige senha de app.