Discourse na VPS: como instalar seu fórum próprio
Monte um fórum próprio com o Discourse numa VPS: requisitos de memória, DNS, instalação oficial com Docker, o que depende do Discourse ID, e-mail, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Discourse na VPS: como instalar seu fórum próprio Arte: Eleven Host
O Discourse na VPS é o caminho para ter um fórum próprio, com o instalador oficial em Docker. Veja os requisitos de memória, o DNS, a instalação passo a passo, o que depende do serviço Discourse ID e como cuidar de e-mail, backup e atualização.
Atualizado em 05/11/2026, com base na documentação oficial do Discourse. Nessa data, as tags mais novas dos repositórios são v2026.10.0 e v2026.11.0-latest, e a página de releases indica a versão 2026.11 em desenvolvimento, com lançamento previsto para 24/11/2026. Trate as versões como um retrato do dia.
O que é o Discourse
A documentação o descreve como uma plataforma para discussão de comunidades, gratuita, aberta e simples. A licença do Discourse é a GNU GPL versão 2.0 ou posterior, e o repositório do instalador (o discourse_docker) usa a licença MIT.
Sobre o método de instalação, a posição oficial é direta: as únicas instalações com suporte oficial são as baseadas em Docker. A equipe diz que não consegue dar suporte a outros métodos, como cPanel, Plesk ou webmin.
Para o Discourse, a documentação indica o mínimo de 1 GB de RAM com swap e recomenda 2 GB ou mais. Confira a memória do plano antes de contratar o servidor.
Requisitos do servidor
Se você ainda não tem uma VPS, o guia de servidor VPS explica o que é e como escolher. Os requisitos da documentação de instalação em nuvem são estes:
- RAM: mínimo de 1 GB com swap, recomendado 2 GB ou mais;
- CPU: mínimo de 1 núcleo, recomendado 2 ou mais;
- disco: mínimo de 10 GB, recomendado 20 GB ou mais;
- sistema: Linux de 64 bits, e a recomendação é uma versão LTS do Ubuntu.
A documentação acrescenta que o instalador ajusta sozinho as variáveis UNICORN_WORKERS e db_shared_buffers de acordo com a memória e a CPU do servidor. Também é preciso acesso por SSH e um servidor com suporte a Docker. O instalador roda em um servidor novo com Ubuntu ou Debian e exige execução como root: o script recusa quem não for root.
Você também precisa de um endereço. A documentação aceita um subdomínio seu, com registro A apontando para o IP do servidor, ou um subdomínio gratuito *.discourse.diy. Para domínios registrados conosco, o DNS gerenciado é grátis na rede da Cloudflare, com painel na área do cliente.
Quanta memória o fórum vai pedir? Confira na loja a memória de cada plano antes de contratar: a documentação do Discourse recomenda 2 GB de RAM ou mais. Ver as VPS
O que depende do Discourse ID
Duas partes do caminho oficial dependem de um serviço externo, o Discourse ID, que é externo ao seu servidor e à Eleven Host:
- O subdomínio gratuito
*.discourse.diy. Para criá-lo, você entra com a sua conta do Discourse (ou cria uma). O processo usa um código de 6 dígitos, válido por 10 minutos, e cria o registro DNS sozinho. Segundo respostas no anúncio da mudança, o subdomínio pode ser retomado se o site ficar inativo; - O login sem SMTP. Quando você pula a configuração de SMTP, o instalador ativa o login pelo Discourse ID.
Quem usa domínio próprio e configura o SMTP não depende dessas duas partes. Desde 2026, o SMTP deixou de ser obrigatório para instalar, mas isso não faz o fórum enviar e-mail sem ele, como a seção de e-mail mostra adiante.
Antes de rodar o instalador
Se for usar domínio próprio, crie antes o registro A do subdomínio (por exemplo, forum.exemplo.com) apontando para o IP do servidor. A documentação avisa que a propagação do DNS pode levar até 48 horas, em geral bem menos.
O assistente confere se as portas 80 e 443 estão disponíveis e se o domínio resolve para o servidor. Se outro programa já usa uma das portas, a documentação sugere parar o nginx ou o apache2. Um exemplo de comandos, para conferir no próprio servidor:
lsof -i :80
lsof -i :443
Instale o Discourse com o comando oficial
A documentação atual traz um comando único, que dispensa o git clone manual:
wget -qO- https://raw.githubusercontent.com/discourse/discourse_docker/main/install-discourse | sudo bash
Segundo a documentação e o script, ele instala o Docker e o git se faltarem, clona a configuração em /var/discourse e abre o assistente de configuração.
Esse comando executa um script como root
O comando baixa um script da internet e o executa com privilégio de root. Isso é o que a documentação oficial pede, e não um defeito. Recomendamos saber o que ele faz antes de rodar: o endereço do script abre no navegador, e você pode lê-lo antes.
O que o assistente pergunta
O discourse-setup segue estas etapas, segundo a documentação: checar os requisitos do sistema (memória, disco e Docker), perguntar a configuração (domínio, e-mail e SMTP), gerar ou atualizar o arquivo containers/app.yml e, se você quiser, reconstruir e iniciar o Discourse. As perguntas principais são:
- os e-mails dos administradores;
- o domínio: o gratuito ou o seu, com um nome como
forum.exemplo.com; - a configuração de SMTP, que você pode pular para usar o login pelo Discourse ID.
Se o assistente pedir swap, o script cria um arquivo de 2 GB no servidor. Para criar o swap por conta própria, siga o passo a passo da documentação de instalação em nuvem do Discourse. A construção leva de 5 a 10 minutos. O assistente aceita as opções --skip-rebuild, --skip-connection-test e --debug.
O HTTPS vem da Let's Encrypt, e a documentação diz que os certificados são emitidos automaticamente, sem configuração adicional.
Edite a configuração e reconstrua
Para mudar algo depois, edite o arquivo de configuração e reconstrua o contêiner:
nano /var/discourse/containers/app.yml
cd /var/discourse
./launcher rebuild app
O launcher tem os comandos start, stop, restart, destroy, enter, logs, bootstrap, rebuild e cleanup. Um exemplo para ver os registros do fórum:
./launcher logs app
Primeiro acesso como administrador
Abra o endereço do fórum no navegador e registre-se com um dos e-mails de administrador informados na instalação. Depois, siga o assistente interno do Discourse para configurar o site.
E-mail: o que o fórum precisa
O README do repositório do instalador diz que, para o Discourse funcionar direito, o e-mail precisa estar configurado, e que a imagem não traz servidor de correio. Sem SMTP, o fórum não envia e-mail: o login fica restrito às opções do Discourse ID (e-mail e contas sociais), e você pode ligar o SMTP depois.
A documentação de e-mail recomenda um serviço dedicado de envio transacional, porque manter um servidor próprio é difícil e pequenos erros atrapalham a entrega. Ela também manda usar um subdomínio verificado no provedor, como discourse.exemplo.com. Preços e cotas variam, então confira no site do serviço que escolher. Se mesmo assim você quiser um servidor de e-mail só seu, veja o guia do Mailcow na VPS.
As variáveis do SMTP ficam no containers/app.yml. Um exemplo, com valores fictícios, que você deve ajustar e conferir na documentação:
DISCOURSE_SMTP_ADDRESS: smtp.exemplo.com
#DISCOURSE_SMTP_PORT: 587
DISCOURSE_SMTP_USER_NAME: usuario@exemplo.com
DISCOURSE_SMTP_PASSWORD: "troque-esta-senha"
Para trocar o serviço de e-mail depois, rode o ./discourse-setup de novo. O fórum fica fora do ar por alguns minutos nesse processo.
Cuide do servidor
A documentação recomenda ativar as atualizações automáticas de segurança do sistema e instalar o fail2ban. Os comandos dela são estes:
dpkg-reconfigure -plow unattended-upgrades
apt install fail2ban
Atualização do Discourse
Há dois caminhos. Pelo painel, abra /admin/upgrade e clique em Upgrade. Pelo terminal, reconstrua o contêiner:
cd /var/discourse
./launcher rebuild app
Um tópico oficial no Meta, editado pela última vez em 21/11/2024, sugere atualizar o Discourse duas vezes por mês pelo atualizador web, o contêiner a cada dois meses e o sistema a cada seis meses. Com pouco espaço em disco, o comando ./launcher cleanup ajuda.
Sobre os canais, a página de releases diz que a maior parte das instalações segue o canal latest. Os lançamentos mensais recebem correções por cerca de dois meses, e a versão ESR, que sai a cada seis meses, recebe atualizações por cerca de oito meses.
Backup do fórum
Segundo o guia oficial do Meta (editado pela última vez em 07/11/2024), as configurações principais são estas:
backup_frequency: o intervalo em dias, com padrão 7 (semanal);backup_time_of_day: o horário em UTC, com padrão 3:30;maximum_backups: quantos backups manter, com padrão 5;backup_with_uploads: inclui os uploads, ativado por padrão.
Os backups locais ficam em /var/discourse/shared/standalone/backups/default. Para usar um bucket S3, o guia lista s3_backup_bucket, s3_access_key_id, s3_secret_access_key, s3_region e backup_location em S3. Ele avisa que guardar backups e uploads no mesmo bucket e na mesma pasta não é mais suportado e não funciona.
Guarde uma cópia fora da VPS
Recomendamos manter uma cópia do backup fora da própria VPS. Como a página do guia é de 2024, confira os nomes e os padrões na tela de configurações do seu fórum.
Plugins
Os plugins entram no containers/app.yml, na seção hooks:, em after_code:, abaixo da linha que já existe. Um exemplo da linha que o guia do Meta usa:
- git clone https://github.com/discourse/discourse-shared-edits.git
Depois, rode cd /var/discourse e ./launcher rebuild app. Para remover um plugin, apague a linha e reconstrua. O YAML exige espaços, e não tabulação.
Outro site na mesma VPS
Esse não é o caminho padrão. O guia do Meta (atualizado em 29/06/2026) marca a configuração como para administradores avançados, e um membro da equipe diz que, para a maioria, é mais fácil usar outro servidor. Quem só quer publicar conteúdo pode olhar o guia do Ghost na VPS, que trata de blog.
O guia diz que o ./discourse-setup não funciona se outro servidor já usa a porta 80 ou a 443. Para dividir a VPS, é preciso um proxy extra, com Nginx ou HAProxy, e mudar o app.yml: comentar os dois templates de SSL, adicionar o web.socketed.template.yml e comentar as portas 80:80 e 443:443. Com isso, o HTTPS e a renovação do certificado passam a ser externos ao contêiner. Um exemplo das linhas do Nginx, para conferir no guia:
proxy_pass http://unix:/var/discourse/shared/standalone/nginx.http.sock:;
proxy_set_header Host $http_host;
proxy_http_version 1.1;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
Para quem vai escolher um servidor
A loja mostra os planos de VPS e a memória de cada um.
Vai abrir um fórum em breve? Antes de contratar, veja na loja a memória de cada plano e compare com os 2 GB de RAM ou mais que a documentação do Discourse recomenda. Ver os planos
Perguntas frequentes
Quanta memória o Discourse pede?
A documentação indica o mínimo de 1 GB de RAM com swap e recomenda 2 GB ou mais.
O SMTP é obrigatório para instalar o Discourse?
Não. A documentação atual trata o SMTP como opcional, e o instalador ativa o login pelo Discourse ID quando você o pula. Mesmo assim, o fórum precisa de SMTP para enviar e-mail.
Dá para instalar o Discourse em cPanel ou Plesk?
Não há suporte oficial. A documentação diz que as únicas instalações com suporte são as baseadas em Docker e cita cPanel, Plesk e webmin como métodos sem suporte.
Preciso de domínio próprio?
Não necessariamente. A documentação aceita o subdomínio gratuito *.discourse.diy, que depende do Discourse ID, ou um subdomínio seu com registro A apontando para o servidor.
A versão 2026.11 já saiu?
Em 05/11/2026, a página de releases mostra a 2026.11 em desenvolvimento, com lançamento previsto para 24/11/2026.