Base de Conhecimento

FreeScout na VPS: atendimento por e-mail da equipe

  • freescout, atendimento por e-mail, caixa compartilhada, vps, lgpd
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: FreeScout na VPS: atendimento por e-mail da equipe

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.

Esta resposta lhe foi útil?

Artigos Relacionados