Base de Conhecimento

Discourse na VPS: como instalar seu fórum próprio

  • discourse, fórum, vps, docker, smtp, comunidade
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Discourse na VPS: como instalar seu fórum próprio

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.

Esta resposta lhe foi útil?

Artigos Relacionados