Estou escrevendo uma documentação curta para administradores de fóruns Discourse que ajudei a configurar. Estou esquecendo algo nela?

Canapin · Dezembro 27, 2025, 5:47pm

Configurei fóruns Discourse para vários amigos/associações. Gostaria que eles fossem mais autônomos na administração, de modo que eu tivesse menos probabilidade de intervir pessoalmente.

Eles usam o Discourse como usuários e co-administradores há meses ou anos. Eles não são “novos administradores”, mas lhes falta conhecimento aprofundado sobre como manter o Discourse diariamente (além do básico de moderação) e o que deve ser conhecido, como administrador, e em caso de problemas técnicos, pois eu sempre estive aqui para cuidar dessas coisas.

Ainda estarei disponível no futuro, mas o objetivo é permitir que eles rastreiem e resolvam as questões mais comuns por conta própria.

Aqui está o que escrevi até agora (traduzido automaticamente para o inglês porque meu texto será escrito em francês, então não se preocupe se algumas frases estiverem estranhas):

Atualizações

Via a interface web

Execute as atualizações quando houver um emoji de carinha triste vermelho no painel de administração (isso significa que há uma atualização importante a ser aplicada).
As atualizações são feitas via:
https://tonforum.fr/admin/upgrade

Às vezes, elas são feitas em duas etapas: você deve primeiro atualizar o “Docker_Manager” antes de poder atualizar o restante:

Via a linha de comando

Às vezes, uma atualização deve ser feita via linha de comando (a página de administração do Discourse indicará explicitamente se for necessário).

Conecte-se ao servidor via SSH
Reconstrua o fórum (uma reconstrução sempre atualiza o Discourse) usando o seguinte comando:
```
/var/discourse/launcher rebuild app
```
De tempos em tempos, depois de confirmar que o fórum está funcionando corretamente, pode ser útil remover imagens do Docker não utilizadas (restos de atualizações anteriores) para liberar espaço em disco:
```
/var/discourse/launcher cleanup
```

Localização de arquivos importantes no servidor

`app.yml`

Contém a configuração do servidor e a lista de plugins instalados. Muito útil se você precisar migrar o fórum para outro servidor ou aplicar certas configurações (por exemplo, mover uploads e backups para outro disco). Ele está localizado aqui:

/var/discourse/containers/app.yml

`mail-receiver.yml`

Contém a configuração para o software que permite receber respostas por e-mail e publicá-las no fórum. Ele está localizado aqui:

/var/discourse/containers/mail-receiver.yml

Backups

Os arquivos de backup são armazenados aqui:

/var/discourse/shared/standalone/backups/default

Páginas importantes na administração do fórum

Algumas páginas que podem ser úteis

Temas e componentes

Eles incluem CSS e HTML personalizados:

https://tonforum.fr/admin/config/customize/themes

Logs

E-mail

Útil para depuração:

https://tonforum.fr/admin/email-logs

Ações da equipe

Muito útil. Ele mantém um registro de (quase) todas as alterações de configuração do site e outras ações realizadas por moderadores e administradores.

https://tonforum.fr/admin/logs/staff_action_logs

Logs de erro

Pode fornecer pistas quando um problema não é óbvio:

https://tonforum.fr/logs/

Backups

Para alterar a frequência de backup e o número máximo de backups, visualizá-los ou baixá-los:

https://tonforum.fr/admin/backups

Recursos

https://meta.discourse.org
Suporte oficial. Não hesite em postar lá; os membros da comunidade e os desenvolvedores geralmente são muito prestativos.

Você vê algo que poderia ser adicionado/removido? Acho que posso remover a parte /logs/, pois é muito, muito raramente útil. Eu nem tenho certeza se encontrei informações úteis nela em muitos anos administrando algumas instâncias.

Ed_S · Dezembro 27, 2025, 9:42pm

Algumas coisas que eu gostaria de deixar claras.

Uma é, no momento de tentar uma atualização pela interface web, esteja ciente de que a atualização pode falhar e seu fórum pode ficar fora do ar. Esteja preparado.

Outra é, se o seu host se tornar inacessível ou corrompido, você precisará dos arquivos de backup e dos arquivos yml. Você precisará tê-los salvos em um local seguro em um sistema separado.

Para combinar as duas: sempre faça um backup e baixe o backup, antes de tentar uma atualização.

Heliosurge · Dezembro 27, 2025, 10:58pm

Olá Ed, pontos muito válidos. Um membro há algum tempo criou um script para fazer backup em outro sistema, se bem me lembro. Precisarei pesquisar e verificar.

Aqui está um trecho da postagem original. Canapin tem uma boa resposta com um link para fazer backup no Google Drive/Dropbox também.

Lhc_fl:

Recentemente, uma amiga minha se deparou com o problema de o provedor de VPS fechar repentinamente sem aviso. Infelizmente, em prol de economizar, ela escolheu um provedor de nicho — um que nem sequer oferecia a opção de download de dados. O que é pior, ela nem tem o hábito de baixar backups regularmente. Da noite para o dia, o site dela desapareceu, juntamente com todos os dados contidos nele.

Chocada com isso, escrevi um script em Powershell que baixará automaticamente backups do seu servidor para o seu computador local regularmente, sem a necessidade de adquirir serviços adicionais de armazenamento de objetos ou gastar um centavo em outras coisas. Tudo o que você precisa é de um computador Windows que você usa regularmente (e que tenha bastante espaço em disco) e esteja conectado à Internet.

O script limpará automaticamente os backups com mais de 5 dias. Você pode definir o intervalo de backup automático e o tempo do backup mais antigo salvo localmente de acordo com suas necessidades.
$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Iniciando a tarefa de download de backup do Discourse..."
Write-Output '------------------------'
Write-Output "Buscando o arquivo de backup mais recente..."
Write-Output ''

while ($true) {

    $filename = ''

    while ($true) {
        try {
            Write-Output "> ssh -p $ssh_port $ssh_address 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'"
            Write-Output ''
            $filename = ssh -p $ssh_port "$ssh_address" 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'
            break
        }
        catch {
            $filename = ''
    
            Write-Output "Falha ao buscar... Aqui está o log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Deseja buscar novamente? (s/N)"
            if ($answer -ne 's') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Erro: Falha ao buscar o nome do arquivo $filename"
        Write-Output ''
        $answer = Read-Host 'Tentar novamente?(s/N)'
  
        if ($answer -eq 's') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Backup mais recente: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename já existe. Deseja baixá-lo novamente?(s/N)"
            Write-Output ''
            if ($answer -ne 's') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Iniciando o download..."
            Write-Output ''
            
            while ($true) {
                try {
                    Write-Output "scp -p $ssh_port ${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename .\\backups\\"
                    Write-Output ''

                    scp -p $ssh_port "${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename" .\\backups\\
                    
                    Write-Output "Download concluído"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download falhou >_<... O log a seguir:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Baixar novamente? (s/N)"
                    Write-Output ''
                    if ($answer -ne 's') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Iniciando a tentativa de limpeza de arquivos de backup antigos..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Excluindo arquivo de backup antigo $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "Ocorreu um erro ao excluir o arquivo de backup antigo $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Foram limpos $count arquivos de backup antigos"
            Write-Output ''
        }
        else {
            Write-Output 'Nenhum arquivo de backup antigo precisa ser limpo'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}
Salve o script acima como nomedoscript.ps1 no caminho onde deseja baixar o backup. Tente “Executar com Powershell”. Se for bem-sucedido, você pode prosseguir para a próxima etapa.

Para agendar uma tarefa

Pesquise por “Agendador de Tarefas”.

Dê um duplo clique em Adicionar Tarefa Agendada. O Assistente para Agendamento de Tarefas é exibido.

Clique em Avançar e depois em Procurar. A caixa de diálogo Selecionar Programa para Agendar aparece.

Navegue até o script que você criou, clique nele e depois em Abrir. Você retorna ao Assistente para Agendamento de Tarefas.

Forneça um nome para a tarefa, ou mantenha o padrão, que é o nome do arquivo, especifique com que frequência executar o script e clique em Avançar.

Especifique a hora e a data de início (se você especificou Diariamente, Semanalmente, Mensalmente, etc.) e recorrência, e clique em Avançar. Este item deve corresponder ao ciclo de backup automático do seu discourse

Digite o nome de usuário e a senha da conta que executará o script e clique em Avançar.

Se desejar configurar propriedades avançadas, selecione a caixa de seleção e clique em Concluir.

@Canapin com o aplicativo de reconstrução do launcher, ele não precisa ser executado como

./launcher r build app

É assim que tenho usado para executá-lo a partir de outros documentos aqui no site. Como aprendi, muitas vezes há muitas maneiras de fazer as coisas. Lol

Ótima descrição, útil.

NateDhaliwal · Dezembro 28, 2025, 12:56am

Mas como você faria cd /var/discourse antes disso, ./ apenas se referiria àquele diretório, então o caminho do launcher é essencialmente /var/discourse/launcher, não é?

Heliosurge · Dezembro 28, 2025, 3:58am

Eu não estava ciente disso. Eu estava apenas usando de acordo com outros tutoriais sobre discourse. Mas faz sentido. Obrigado

Ed_S · Dezembro 28, 2025, 6:01am

Eu me pergunto se vale a pena adicionar algumas dicas de escalonamento? Se a pessoa que está lendo o documento não souber como usar ssh no host, para investigar ou corrigir, quem saberá? Talvez uma dica sobre fazer perguntas aqui no meta, talvez também uma dica sobre usar ask.

Jonathan5 · Dezembro 28, 2025, 11:42pm

É bom saber disso. Eu só sabia sobre baixar o backup criado pelo próprio fórum.

Canapin · Dezembro 29, 2025, 2:09pm

Obrigado pela sua ajuda!

Adicionei isto no início do meu guia:

Certifique-se de estar preparado para qualquer situação

É fortemente recomendado, além dos backups locais (salvos no mesmo servidor do fórum), ter uma cópia desses backups em outro servidor ou na nuvem^[1].

Também é útil manter uma cópia do arquivo /var/discourse/containers/app.yml em um local seguro^[2]. Este arquivo opcional é usado em caso de reinstalação do fórum ou migração para outro servidor.

Se houver qualquer dúvida séria sobre qualquer coisa, entre em contato comigo (canapin@gmail.com).

Adicionei isto na seção de atualização:

Antes de fazer uma atualização, é altamente recomendável baixar o backup mais recente do seu fórum.

Adicionei isto:

O que fazer se o fórum não funcionar mais?

Reconstruir o fórum resolve muitos problemas e é feito com o mesmo comando de uma atualização pela linha de comando:
/var/discourse/launcher rebuild app
E se o fórum ainda não funcionar após uma reconstrução?

Pergunte a mim (canapin@gmail.com) ou poste no fórum de suporte oficial.

Também mencionei ask.discourse.org no final do guia.

Recursos

https://meta.discourse.org : suporte oficial, não hesite em postar lá — membros da comunidade e desenvolvedores são muito prestativos
https://ask.discourse.com : um chatbot treinado em suporte e dados do Discourse, surpreendentemente eficaz para responder perguntas (sim, de verdade)

Texto completo

Make sure you’re prepared for any situation

It is strongly recommended, in addition to local backups (saved on the same server as the forum), to have a copy of these backups on another server or in the cloud^[1:1].

It is also useful to keep a copy of the file /var/discourse/containers/app.yml in a secure place^[2:1]. This optional file is used in case of a forum reinstallation or a migration to another server.

If there is any serious doubt about anything, contact me (canapin@gmail.com).

Updates

Before doing an update, it is strongly recommended to download the latest backup of your forum.

Via the interface

Do updates when there is an unhappy red smiley in the admin (it means there is an important update to do).
Updates are done via https://yourforum.com/admin/upgrade

They are sometimes done in two steps: you first need to update “Docker_Manager” before being able to upgrade the rest:

Via the command line

Sometimes, an update must be done via the command line (the Discourse admin page will say so if needed).

Connect to the server via SSH
Rebuild the forum (a rebuild always updates Discourse) using the following command:
```
/var/discourse/launcher rebuild app
```
From time to time, after making sure the forum works correctly, it can be useful to remove unused Docker images (leftovers from previous upgrades) to free up disk space:
```
/var/discourse/launcher cleanup
```

What to do if the forum no longer works?

Rebuilding the forum fixes many problems and is done with the same command as a command-line update:

/var/discourse/launcher rebuild app

Acho que está bem bom agora e que não estou esquecendo nada importante :slight_smile:

If I installed your forum, your backups are automatically copied to my Google Drive, but ideally in the future they should be saved on a space you are responsible for. We’ll talk about it one day ↩︎ ↩︎
It contains the mail server username and password as well as the top-level administrator email (mine, actually). ↩︎ ↩︎

Jonathan5 · Dezembro 29, 2025, 6:52pm

Se isso funcionar, seria uma recomendação melhor (mais simples) do que a versão usual de duas linhas (que costumava ser de três, então podemos continuar a tendência).

merefield · Dezembro 29, 2025, 7:16pm

Ambos funcionam.

Se você estiver no diretório ./ É necessário porque a localização do lançador não está no path.

O Linux exige que, se um comando não estiver no path, você forneça seu caminho completo para que não haja engano sobre qual arquivo você quis dizer.

merefield · Dezembro 29, 2025, 7:19pm

Sim, mas muitas vezes você pode estar fazendo várias coisas, por exemplo, uma limpeza primeiro. Nesse caso, o cd primeiro pode acabar sendo mais breve.

Andrew_Rowe · Dezembro 30, 2025, 2:27am

Eu concordo e marquei o tópico como favorito para uso futuro, obrigado

Canapin · Dezembro 30, 2025, 4:17pm

Ah bem, aqui está o guia completo traduzido automaticamente então:

Garantindo que você esteja preparado para qualquer eventualidade

É fortemente recomendado, além de backups locais (armazenados no mesmo servidor que o fórum), ter uma cópia desses backups em outro servidor ou na nuvem^[1].

Também é útil manter uma cópia do arquivo /var/discourse/containers/app.yml em um local seguro^[2]. Este arquivo opcional é útil em caso de reinstalação do fórum ou migração para outro servidor.

~~Se você tiver alguma dúvida séria sobre qualquer coisa, entre em contato comigo.~~

Atualizações

Antes de fazer uma atualização, é altamente recomendável baixar o backup mais recente do seu fórum.

Via a interface

Faça as atualizações quando houver um emoticon vermelho triste no administrador (significa que há uma atualização importante a ser feita).
As atualizações são feitas via https://tonforum.fr/admin/upgrade

Às vezes, elas ocorrem em duas etapas: você primeiro precisa atualizar o “Docker_Manager” antes de poder atualizar o restante:

Via a linha de comando

Às vezes, uma atualização precisa ser feita via linha de comando (a página de administração do Discourse informará se for necessário).

Conecte-se ao servidor via SSH
Reconstrua o fórum (uma reconstrução sempre atualiza o Discourse) usando o seguinte comando:
```
/var/discourse/launcher rebuild app
```
De tempos em tempos, depois de garantir que o fórum está funcionando corretamente, pode ser útil remover imagens Docker não utilizadas (restos de atualizações anteriores) para liberar espaço em disco:
```
/var/discourse/launcher cleanup
```

O que fazer se o fórum parar de funcionar?

Reconstruir o fórum resolve muitos problemas e é feito com o mesmo comando de uma atualização via linha de comando:

/var/discourse/launcher rebuild app

E se o fórum ainda não funcionar após uma reconstrução?

~~Pergunte a mim ou~~ poste no fórum de suporte oficial.

Localização de arquivos importantes no servidor

`app.yml`

Ele contém a configuração do servidor e a lista de plugins instalados. Muito útil se o fórum precisar ser movido para outro servidor, ou para certas configurações (mover uploads e backups para outro disco, por exemplo). Ele está localizado aqui:

/var/discourse/containers/app.yml

`mail-receiver.yml`

Ele contém a configuração do software que permite que respostas por e-mail sejam recebidas e publicadas no fórum. Ele está localizado aqui:

/var/discourse/containers/mail-receiver.yml

Backups

Os arquivos de backup estão localizados aqui:

/var/discourse/shared/standalone/backups/default

Páginas importantes na administração do fórum:

Páginas que podem ser úteis

Temas e componentes

Eles contêm, entre outras coisas, CSS e HTML personalizados:

https://tonforum.fr/admin/config/customize/themes

Logs

E-mail

Útil para depuração:

https://tonforum.fr/admin/email-logs

Ações da equipe

Muito útil. Ele mantém um registro de (quase) todas as alterações nas configurações do site e outras ações de moderadores e administradores.

https://tonforum.fr/admin/logs/staff_action_logs

Logs de erro

Pode dar pistas quando há um problema cuja causa não é óbvia.

https://tonforum.fr/logs/

Backups

Para alterar a frequência e o número máximo de backups, visualize-os ou baixe-os:

https://tonforum.fr/admin/backups

Recursos

https://meta.discourse.org : suporte oficial, não hesite em postar lá, membros e desenvolvedores ficam felizes em ajudar
https://ask.discourse.com : um chatbot treinado em suporte e dados do Discourse, surpreendentemente eficaz em responder perguntas (sim, realmente)

Se eu instalei seu fórum, seus backups são copiados automaticamente para o meu Google Drive, mas idealmente no futuro eles devem ser salvos em um espaço do qual você é responsável. Falaremos sobre isso um dia ↩︎
Ele contém o identificador e a senha para o servidor de e-mail, bem como o e-mail do administrador ~~(o meu, na verdade)~~. ↩︎

Tópico		Respostas	Visualizações
MKJ's Opinionated Discourse Deployment Configuration Sysadmins explanation , install	32	6732	15 de Dezembro de 2025
Problem when updating Discourse Forum Installation unsupported-install	20	2009	29 de Junho de 2023
Digital Ocean hosting: Do I need a system admin? Hosting	28	6701	14 de Dezembro de 2017
How to backup and restore a whole /var/discourse app folder? Installation	17	5554	19 de Junho de 2020
Improving import and export support Feature	29	8433	8 de Outubro de 2014

Estou escrevendo uma documentação curta para administradores de fóruns Discourse que ajudei a configurar. Estou esquecendo algo nela?

Atualizações

Via a interface web

Via a linha de comando

Localização de arquivos importantes no servidor

app.yml

mail-receiver.yml

Backups

Páginas importantes na administração do fórum

Temas e componentes

Logs

E-mail

Ações da equipe

Logs de erro

Backups

Recursos

Certifique-se de estar preparado para qualquer situação

O que fazer se o fórum não funcionar mais?

E se o fórum ainda não funcionar após uma reconstrução?

Recursos

Make sure you’re prepared for any situation

Updates

Via the interface

Via the command line

What to do if the forum no longer works?

Garantindo que você esteja preparado para qualquer eventualidade

Atualizações

Via a interface

Via a linha de comando

O que fazer se o fórum parar de funcionar?

E se o fórum ainda não funcionar após uma reconstrução?

Localização de arquivos importantes no servidor

app.yml

mail-receiver.yml

Backups

Páginas importantes na administração do fórum:

Temas e componentes

Logs

E-mail

Ações da equipe

Logs de erro

Backups

Recursos

Tópicos relacionados

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`