J'écris une courte documentation pour les admins des forums Discourse que j'ai aidé à configurer. Est-ce que j'oublie quelque chose ?

Canapin · Décembre 27, 2025, 5:47

J’ai configuré des forums Discourse pour plusieurs amis/associations. J’aimerais qu’ils soient plus autonomes dans l’administration, de sorte que j’aie moins de chances d’intervenir moi-même.

Ils utilisent Discourse en tant qu’utilisateurs et co-administrateurs depuis des mois, voire des années. Ce ne sont pas des « nouveaux administrateurs », mais ils manquent de connaissances approfondies sur la façon de maintenir Discourse au quotidien (au-delà des bases de la modération) et sur ce qu’il faut savoir en tant qu’administrateur, et en cas de problèmes techniques, car j’étais toujours là pour m’occuper de ces choses.

Je serai toujours disponible à l’avenir, mais l’objectif est de leur permettre de suivre et de résoudre eux-mêmes les problèmes les plus courants.

Voici ce que j’ai écrit jusqu’à présent (traduit automatiquement en anglais car mon texte sera rédigé en français, donc ne faites pas attention si certaines phrases sont étranges) :

Mises à jour

Via l’interface web

Effectuez les mises à jour lorsqu’un smiley rouge mécontent apparaît dans le panneau d’administration (cela signifie qu’une mise à jour importante doit être appliquée).
Les mises à jour se font via :
https://tonforum.fr/admin/upgrade

Elles se font parfois en deux étapes : vous devez d’abord mettre à jour « Docker_Manager » avant de pouvoir mettre à jour le reste :

Via la ligne de commande

Parfois, une mise à jour doit être effectuée via la ligne de commande (la page d’administration de Discourse l’indiquera explicitement si nécessaire).

Connectez-vous au serveur via SSH
Reconstruisez le forum (une reconstruction met toujours à jour Discourse) en utilisant la commande suivante :
```
/var/discourse/launcher rebuild app
```
De temps en temps, une fois que vous avez confirmé que le forum fonctionne correctement, il peut être utile de supprimer les images Docker inutilisées (restes des mises à jour précédentes) pour libérer de l’espace disque :
```
/var/discourse/launcher cleanup
```

Emplacement des fichiers importants sur le serveur

`app.yml`

Contient la configuration du serveur et la liste des plugins installés. Très utile si vous avez besoin de migrer le forum vers un autre serveur ou d’appliquer certaines configurations (par exemple, déplacer les téléchargements et les sauvegardes vers un autre disque). Il est situé ici :

/var/discourse/containers/app.yml

`mail-receiver.yml`

Contient la configuration du logiciel qui permet de recevoir les réponses par e-mail et de les publier sur le forum. Il est situé ici :

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

Sauvegardes (Backups)

Les fichiers de sauvegarde sont stockés ici :

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

Pages importantes dans l’administration du forum

Quelques pages qui peuvent être utiles

Thèmes et composants

Ils incluent le CSS et le HTML personnalisés :

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

Journaux (Logs)

E-mail

Utile pour le débogage :

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

Actions du personnel (Staff actions)

Très utile. Il conserve un enregistrement de (presque) toutes les modifications des paramètres du site et des autres actions effectuées par les modérateurs et les administrateurs.

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

Journaux d’erreurs (Error logs)

Peut fournir des indices lorsqu’un problème n’est pas évident :

https://tonforum.fr/logs/

Sauvegardes (Backups)

Pour modifier la fréquence des sauvegardes et le nombre maximal de sauvegardes, les visualiser ou les télécharger :

https://tonforum.fr/admin/backups

Ressources

https://meta.discourse.org
Support officiel. N’hésitez pas à y publier ; les membres de la communauté et les développeurs sont généralement très serviables.

Voyez-vous des choses qui pourraient être ajoutées/supprimées ? Je pense que je peux supprimer la partie /logs/, car elle est très, très rarement utile. Je ne suis même pas sûr d’y avoir trouvé des informations utiles en de nombreuses années d’administration de quelques instances.

Ed_S · Décembre 27, 2025, 9:42

Quelques points que je voudrais clarifier.

L’un est, au moment d’essayer une mise à jour via l’interface web, sachez que la mise à jour peut échouer et que votre forum peut être hors service. Soyez prêt.

L’autre est, si votre hôte devient inaccessible ou corrompu, vous aurez besoin des fichiers de sauvegarde et des fichiers yml. Vous devrez les avoir déjà mis en lieu sûr sur un système séparé.

Pour combiner les deux : faites toujours une sauvegarde et téléchargez la sauvegarde avant d’essayer une mise à jour.

Heliosurge · Décembre 27, 2025, 10:58

Bonjour Ed, points très valables. Un membre a créé un script pour sauvegarder sur un autre système il y a quelque temps, si je me souviens bien. Il faudra faire une recherche et vérifier.

Voici un extrait du message initial. Canapin a une bonne réponse avec un lien vers la sauvegarde sur Google Drive/Dropbox également.

Lhc_fl:

Récemment, une amie a rencontré le problème du fournisseur de VPS qui a soudainement cessé ses activités sans préavis. Malheureusement, pour des raisons de coût, elle a choisi un fournisseur de niche - un qui n’offrait même pas de téléchargement de données. Le pire est qu’elle n’a même pas l’habitude de télécharger régulièrement des sauvegardes. Du jour au lendemain, son site a disparu, ainsi que toutes les données qu’il contenait.

Choquée par cela, j’ai écrit un script Powershell qui téléchargera automatiquement les sauvegardes de votre serveur sur votre ordinateur local régulièrement sans avoir à acheter de services de stockage d’objets supplémentaires ou à dépenser un centime pour d’autres choses. Tout ce dont vous avez besoin est un ordinateur Windows que vous utilisez régulièrement (et qui dispose de beaucoup d’espace disque) et qui est connecté à Internet.

Le script supprimera automatiquement les sauvegardes datant de plus de 5 jours. Vous pouvez définir l’intervalle de sauvegarde automatique et l’ancienneté de la sauvegarde conservée localement en fonction de vos besoins.
$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Starting Discourse backup download task..."
Write-Output '------------------------'
Write-Output "Fetching the latest backup file..."
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 "Failed to fetch... Here is the log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Do you want to re-fetch? (y/N)"
            if ($answer -ne 'y') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Error: Failed to fetch file name $filename"
        Write-Output ''
        $answer = Read-Host 'Retry?(y/N)'
  
        if ($answer -eq 'y') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Latest backup: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename already exists. Do you want to download it again?(y/N)"
            Write-Output ''
            if ($answer -ne 'y') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Start downloading..."
            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 completed"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download failed >_<... The following is the log:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Download again? (y/N)"
                    Write-Output ''
                    if ($answer -ne 'y') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Start trying to clean old backup files..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Delete old backup file $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "An error occurred while deleting old backup file $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Cleaned $count old backup files"
            Write-Output ''
        }
        else {
            Write-Output 'No old backup files need to clean up'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}
Enregistrez ce script sous scriptname.ps1 dans le chemin où vous souhaitez télécharger la sauvegarde. Essayez « Exécuter avec Powershell ». Si cela réussit, vous pouvez passer à l’étape suivante.

Pour planifier une tâche

Recherchez « Tâches planifiées ».

Double-cliquez sur Ajouter une tâche planifiée. L’Assistant Tâche planifiée apparaît.

Cliquez sur Suivant, puis cliquez sur Parcourir. La boîte de dialogue Sélectionner un programme à planifier apparaît.

Naviguez jusqu’au script que vous avez créé, cliquez dessus, puis sur Ouvrir. Vous revenez à l’Assistant Tâche planifiée.

Fournissez un nom pour la tâche, ou conservez celui par défaut, qui est le nom du fichier, spécifiez la fréquence d’exécution du script, puis cliquez sur Suivant.

Spécifiez l’heure et la date de début (si vous avez spécifié Quotidien, Hebdomadaire, Mensuel, etc.) et la récurrence, puis cliquez sur Suivant. Cet élément doit correspondre au cycle de sauvegarde automatique de votre discourse

Saisissez le nom d’utilisateur et le mot de passe du compte qui exécutera le script, puis cliquez sur Suivant.

Si vous souhaitez configurer des propriétés avancées, cochez la case, puis cliquez sur Terminer.

@Canapin avec l’application de reconstruction du lanceur, ne doit-elle pas être exécutée comme

./launcher r build app

C’est juste la façon dont j’ai l’habitude de l’exécuter à partir d’autres documents ici sur le site. Comme j’ai appris, il y a souvent plusieurs façons de faire les choses. Lol

Bonne rédaction, pratique.

NateDhaliwal · Décembre 28, 2025, 12:56

Mais puisque vous feriez cd /var/discourse avant cela, ./ ferait référence à ce répertoire, donc le chemin de launcher est essentiellement /var/discourse/launcher, non ?

Heliosurge · Décembre 28, 2025, 3:58

Je n’étais pas au courant de cela. Je l’ai juste utilisé conformément à d’autres tutoriels sur Discourse. Mais cela a du sens. Merci.

Ed_S · Décembre 28, 2025, 6:01

Je me demande s’il vaut la peine d’ajouter quelques conseils d’escalade ? Si la personne qui lit le document ne sait pas comment se connecter en ssh à l’hôte, pour enquêter ou réparer, qui le peut ? Peut-être un conseil sur la façon de poser des questions ici sur meta, peut-être aussi un conseil sur l’utilisation de ask.

Jonathan5 · Décembre 28, 2025, 11:42

C’est bon à savoir. Je ne connaissais que le téléchargement de la sauvegarde créée par le forum lui-même.

Canapin · Décembre 29, 2025, 2:09

Merci pour votre aide !

J’ai ajouté ceci au début de mon guide :

Assurez-vous d’être préparé à toute situation

Il est fortement recommandé, en plus des sauvegardes locales (enregistrées sur le même serveur que le forum), d’avoir une copie de ces sauvegardes sur un autre serveur ou dans le cloud^[1].
^[1:1] : Si j’ai installé votre forum, vos sauvegardes sont automatiquement copiées sur mon Google Drive, mais idéalement à l’avenir elles devraient être sauvegardées sur un espace dont vous êtes responsable. On en parlera un jour

Il est également utile de conserver une copie du fichier /var/discourse/containers/app.yml dans un endroit sûr^[2]. Ce fichier optionnel sert en cas de réinstallation du forum ou de migration vers un autre serveur.

^[2:1] : Il contient le nom d’utilisateur et le mot de passe du serveur de messagerie ainsi que l’email de l’administrateur (le mien, en fait).

En cas de doute sérieux sur quoi que ce soit, contactez-moi (canapin@gmail.com).

Ajouté ceci dans la section mise à jour :

Avant de faire une mise à jour, il est fortement recommandé de télécharger la dernière sauvegarde de votre forum.

Ajouté ceci :

Que faire si le forum ne fonctionne plus ?

Reconstruire le forum résout beaucoup de problèmes et se fait avec la même commande qu’une mise à jour en ligne de commande :
/var/discourse/launcher rebuild app
Et si le forum ne fonctionne toujours pas après une reconstruction ?

Demandez-moi (canapin@gmail.com) ou postez sur le forum de support officiel.

J’ai aussi mentionné ask.discourse.org à la fin du guide.

Ressources

https://meta.discourse.org : support officiel, n’hésitez pas à y poster — les membres de la communauté et les développeurs sont très serviables
https://ask.discourse.com : un chatbot entraîné sur le support et les données de Discourse, étonnamment efficace pour répondre aux questions (oui, vraiment)

Texte intégral

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:2].

It is also useful to keep a copy of the file /var/discourse/containers/app.yml in a secure place^[2:2]. 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 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

Je pense que c’est assez bien maintenant et que je n’oublie rien d’important

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 · Décembre 29, 2025, 6:52

Si cela fonctionne, ce serait une meilleure recommandation (plus simple) que la version habituelle en deux lignes (qui en comptait trois auparavant, nous pouvons donc continuer la tendance).

merefield · Décembre 29, 2025, 7:16

Les deux fonctionnent.

Si vous êtes dans le répertoire ./ C’est nécessaire car l’emplacement du lanceur n’est pas dans le chemin (path).

Linux exige que si une commande n’est pas dans le chemin (path), vous donniez son chemin complet afin qu’il n’y ait aucune erreur sur le fichier que vous vouliez exécuter.

merefield · Décembre 29, 2025, 7:19

Oui, mais souvent vous pourriez faire plusieurs choses, par exemple un nettoyage d’abord. Auquel cas, se placer d’abord avec cd pourrait être plus bref.

Andrew_Rowe · Décembre 30, 2025, 2:27

Je suis d’accord et j’ai mis le sujet en favori pour une utilisation future, merci

Canapin · Décembre 30, 2025, 4:17

Voici donc le guide complet traduit automatiquement :

S’assurer que vous êtes préparé à toute éventualité

Il est fortement recommandé, en plus des sauvegardes locales (stockées sur le même serveur que le forum), d’avoir une copie de ces sauvegardes sur un autre serveur ou dans le cloud^[1].

Il est également utile de conserver une copie du fichier /var/discourse/containers/app.yml dans un endroit sûr^[2]. Ce fichier optionnel est utile en cas de réinstallation du forum ou de migration vers un autre serveur.

~~Si vous avez des doutes sérieux sur quoi que ce soit, contactez-moi.~~

Mises à jour

Avant de faire une mise à jour, il est fortement recommandé de télécharger la dernière sauvegarde de votre forum.

Via l’interface

Faites les mises à jour lorsqu’il y a un smiley rouge mécontent dans l’administration (cela signifie qu’il y a une mise à jour importante à faire).
Les mises à jour se font via https://tonforum.fr/admin/upgrade

Elles se font parfois en deux étapes : il faut d’abord mettre à jour “Docker_Manager” avant de pouvoir mettre à jour le reste :

Via la ligne de commande

Parfois une mise à jour doit se faire via la ligne de commande (la page d’administration de Discourse le signalera si c’est nécessaire).

Connectez-vous au serveur via SSH
Reconstruisez le forum (une reconstruction met toujours à jour Discourse) avec la commande suivante :
```
/var/discourse/launcher rebuild app
```
De temps en temps, après vous être assuré que le forum fonctionne correctement, il peut être utile de supprimer les images Docker inutilisées (les restes des mises à jour précédentes) pour libérer de l’espace disque :
```
/var/discourse/launcher cleanup
```

Que faire si le forum ne fonctionne plus ?

Reconstruire le forum règle beaucoup de problèmes et se fait avec la même commande qu’une mise à jour via la ligne de commande :

/var/discourse/launcher rebuild app

Et si le forum ne fonctionne toujours pas après une reconstruction ?

~~Demandez-moi ou~~ postez sur le forum de support officiel.

Emplacement des fichiers importants sur le serveur

`app.yml`

Il contient la configuration du serveur et la liste des plugins installés. Très utile si le forum doit être déplacé sur un autre serveur, ou pour certaines configurations (déplacer les uploads et les sauvegardes sur un autre disque, par exemple). Il se trouve ici :

/var/discourse/containers/app.yml

`mail-receiver.yml`

Il contient la configuration du logiciel qui permet de recevoir et publier sur le forum les réponses par email. Il se trouve ici :

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

Sauvegardes (Backups)

Les fichiers de sauvegarde se trouvent ici :

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

Pages importantes dans l’administration du forum :

Pages qui peuvent être utiles

Thèmes et composants

Ils contiennent, entre autres, du CSS et du HTML personnalisé :

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

Journaux (Logs)

Email

Utile pour le débogage :

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

Actions du personnel (Staff actions)

Très utile. Il garde une trace de (presque) tous les changements de paramètres du site et des autres actions des modérateurs et administrateurs.

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

Journaux d’erreurs (Error logs)

Peut donner des indices lorsqu’il y a un problème dont la cause n’est pas évidente.

https://tonforum.fr/logs/

Sauvegardes (Backups)

Pour modifier la fréquence et le nombre maximum de sauvegardes, les visualiser, ou les télécharger :

https://tonforum.fr/admin/backups

Ressources

https://meta.discourse.org : support officiel, n’hésitez pas à y poster, les membres et les développeurs sont heureux d’aider
https://ask.discourse.com : un agent conversationnel entraîné sur le support et les données de Discourse, étonnamment efficace pour répondre aux questions (oui, vraiment)

Si j’ai installé votre forum, vos sauvegardes sont automatiquement copiées sur mon Google Drive, mais idéalement à l’avenir elles devraient être sauvegardées sur un espace dont vous êtes responsable. On en parlera un jour ↩︎
Il contient l’identifiant et le mot de passe du serveur mail, ainsi que l’email administrateur ~~(le mien, en fait)~~. ↩︎

Sujet		Réponses	Vues
MKJ's Opinionated Discourse Deployment Configuration Sysadmins explanation , install	32	6732	Décembre 15, 2025
Problem when updating Discourse Forum Installation unsupported-install	20	2011	Juin 29, 2023
Digital Ocean hosting: Do I need a system admin? Hosting	28	6701	Décembre 14, 2017
How to backup and restore a whole /var/discourse app folder? Installation	17	5554	Juin 19, 2020
Improving import and export support Feature	29	8433	Octobre 8, 2014

J'écris une courte documentation pour les admins des forums Discourse que j'ai aidé à configurer. Est-ce que j'oublie quelque chose ?

Mises à jour

Via l’interface web

Via la ligne de commande

Emplacement des fichiers importants sur le serveur

app.yml

mail-receiver.yml

Sauvegardes (Backups)

Pages importantes dans l’administration du forum

Thèmes et composants

Journaux (Logs)

E-mail

Actions du personnel (Staff actions)

Journaux d’erreurs (Error logs)

Sauvegardes (Backups)

Ressources

Assurez-vous d’être préparé à toute situation

Que faire si le forum ne fonctionne plus ?

Et si le forum ne fonctionne toujours pas après une reconstruction ?

Ressources

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?

S’assurer que vous êtes préparé à toute éventualité

Mises à jour

Via l’interface

Via la ligne de commande

Que faire si le forum ne fonctionne plus ?

Et si le forum ne fonctionne toujours pas après une reconstruction ?

Emplacement des fichiers importants sur le serveur

app.yml

mail-receiver.yml

Sauvegardes (Backups)

Pages importantes dans l’administration du forum :

Thèmes et composants

Journaux (Logs)

Email

Actions du personnel (Staff actions)

Journaux d’erreurs (Error logs)

Sauvegardes (Backups)

Ressources

Sujets connexes

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`