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

**URL:** https://meta.discourse.org/t/im-writing-a-short-documentation-for-admins-of-discourse-forums-ive-helped-set-up-do-i-miss-something-in-it/392246
**Category:** General
**Created:** [Dezembro 27, 2025, 5:47pm UTC](https://meta.discourse.org/t/im-writing-a-short-documentation-for-admins-of-discourse-forums-ive-helped-set-up-do-i-miss-something-in-it/392246 "2025-12-27T17:47:25Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [Dezembro 27, 2025, 5:47pm UTC](https://meta.discourse.org/t/im-writing-a-short-documentation-for-admins-of-discourse-forums-ive-helped-set-up-do-i-miss-something-in-it/392246/1 "2025-12-27T17:47:25Z")

</div>

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:

 ![a5c47ed958003ef613f527d047b9f78887a9f7f9](https://global.discourse-cdn.com/meta/original/4X/a/5/c/a5c47ed958003ef613f527d047b9f78887a9f7f9.png)

## 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).

1. Conecte-se ao servidor via SSH
2. Reconstrua o fórum (uma reconstrução sempre atualiza o Discourse) usando o seguinte comando:
3. 

```plaintext
/var/discourse/launcher rebuild app

```

4. 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:

```plaintext
/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:

```plaintext
/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:

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

```

## Backups

Os arquivos de backup são armazenados aqui:

```plaintext
/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:

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

```

## Logs

### E-mail

Útil para depuração:

```plaintext
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.

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

```

### Logs de erro

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

```plaintext
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:

```plaintext
https://tonforum.fr/admin/backups

```

# Recursos

[https://meta.discourse.org](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.

---

_[View the full topic](https://meta.discourse.org/t/im-writing-a-short-documentation-for-admins-of-discourse-forums-ive-helped-set-up-do-i-miss-something-in-it/392246)._