Sto scrivendo una breve documentazione per gli admin dei forum Discourse che ho aiutato a configurare. Mi manca qualcosa?

Canapin · 27 Dicembre 2025, 5:47pm

J’ai configurato forum Discourse per diversi amici/associazioni. Vorrei che fossero più autonomi nell’amministrazione, in modo da intervenire meno io stesso.

Usano Discourse come utenti e co-amministratori da mesi o anni. Non sono “nuovi amministratori”, ma mancano loro di una conoscenza approfondita su come mantenere Discourse quotidianamente (al di fuori delle basi della moderazione) e su cosa si dovrebbe sapere, in quanto amministratori, in caso di problemi tecnici, poiché sono sempre stato io a occuparmi di tali cose.

Sarò ancora disponibile in futuro, ma l’obiettivo è consentire loro di monitorare e risolvere da soli i problemi più comuni.

Ecco cosa ho scritto finora (tradotto automaticamente in inglese perché il mio testo sarà scritto in francese, quindi non fate caso se alcune frasi sono strane):

Aggiornamenti

Tramite l’interfaccia web

Eseguire gli aggiornamenti quando compare una faccina rossa triste nel pannello di amministrazione (indica che c’è un aggiornamento importante da applicare).
Gli aggiornamenti si eseguono tramite:
https://tonforum.fr/admin/upgrade

A volte si svolgono in due fasi: potrebbe essere necessario aggiornare prima “Docker_Manager” prima di poter aggiornare il resto:

Tramite riga di comando

A volte, un aggiornamento deve essere eseguito tramite riga di comando (la pagina di amministrazione di Discourse lo indicherà esplicitamente se necessario).

Connettersi al server tramite SSH
Ricostruire il forum (una ricostruzione aggiorna sempre Discourse) usando il seguente comando:
```
/var/discourse/launcher rebuild app
```
Di tanto in tanto, una volta confermato che il forum funziona correttamente, può essere utile rimuovere le immagini Docker inutilizzate (avanzi degli aggiornamenti precedenti) per liberare spazio su disco:
```
/var/discourse/launcher cleanup
```

Posizione dei file importanti sul server

`app.yml`

Contiene la configurazione del server e l’elenco dei plugin installati. Molto utile se si deve migrare il forum su un altro server o applicare determinate configurazioni (ad esempio, spostare caricamenti e backup su un altro disco). Si trova qui:

/var/discourse/containers/app.yml

`mail-receiver.yml`

Contiene la configurazione del software che consente di ricevere risposte via email e pubblicarle sul forum. Si trova qui:

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

Backup

I file di backup sono memorizzati qui:

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

Pagine importanti nell’amministrazione del forum

Alcune pagine che possono essere utili

Temi e componenti

Includono CSS e HTML personalizzati:

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

Log

Email

Utili per il debug:

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

Azioni dello staff

Molto utili. Conservano una registrazione di (quasi) tutte le modifiche alle impostazioni del sito e altre azioni eseguite da moderatori e amministratori.

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

Log degli errori

Possono fornire indizi quando un problema non è ovvio:

https://tonforum.fr/logs/

Backup

Per modificare la frequenza dei backup e il numero massimo di backup, visualizzarli o scaricarli:

https://tonforum.fr/admin/backups

Risorse

https://meta.discourse.org
Supporto ufficiale. Non esitate a pubblicare lì; i membri della community e gli sviluppatori sono solitamente molto disponibili.

Vedete qualcosa che si potrebbe aggiungere/rimuovere? Penso di poter rimuovere la parte /logs/, dato che è molto, molto raramente utile. Non sono nemmeno sicuro di aver trovato informazioni utili in essa in molti anni di amministrazione di alcune istanze.

Ed_S · 27 Dicembre 2025, 9:42pm

Un paio di cose che vorrei chiarire.

Una è che, nel momento in cui si tenta un aggiornamento tramite interfaccia web, siate consapevoli che l’aggiornamento potrebbe fallire e il vostro forum potrebbe essere inattivo. Siate preparati.

Un’altra è che, se il vostro host diventa inaccessibile o corrotto, avrete bisogno dei file di backup e dei file yml. Dovrete averli già salvati in un luogo sicuro su un sistema separato.

Per combinare le due cose: fate sempre un backup e scaricate il backup, prima di tentare un aggiornamento.

Heliosurge · 27 Dicembre 2025, 10:58pm

Ciao Ed, punti molto validi. Un membro tempo fa ha creato uno script per il backup su un altro sistema, se ricordo bene. Dovrò fare una ricerca e controllare.

Ecco un estratto dal post originale. Canapin ha una buona risposta con un link per il backup su Google Drive/Dropbox.

Lhc_fl:

Recentemente, un mio amico si è imbattuto nel problema che il fornitore di VPS ha chiuso improvvisamente senza preavviso. Purtroppo, per risparmiare, ha scelto un fornitore di nicchia, uno che non offriva nemmeno il download dei dati. Peggio ancora, non aveva nemmeno l’abitudine di scaricare regolarmente i backup. Da un giorno all’altro, il suo sito è scomparso, insieme a tutti i dati in esso contenuti.

Scioccato da questo, ho scritto uno script Powershell che scaricherà automaticamente i backup dal tuo server al tuo computer locale regolarmente senza dover acquistare servizi di archiviazione oggetti aggiuntivi o spendere un centesimo per altre cose. Tutto ciò di cui hai bisogno è un computer Windows che usi regolarmente (e che abbia molto spazio su disco) e che sia connesso a Internet.

Lo script pulirà automaticamente i backup di 5 giorni fa. Puoi impostare l’intervallo di backup automatico e il tempo del backup più vecchio salvato localmente in base alle tue esigenze.
$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Avvio attività di download backup di Discourse..."
Write-Output '------------------------'
Write-Output "Recupero del file di backup più 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 "Recupero fallito... Ecco il log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Vuoi recuperare di nuovo? (s/N)"
            if ($answer -ne 's') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Errore: impossibile recuperare il nome del file $filename"
        Write-Output ''
        $answer = Read-Host 'Riprova?(s/N)'
  
        if ($answer -eq 's') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Backup più recente: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename esiste già. Vuoi scaricarlo di nuovo?(s/N)"
            Write-Output ''
            if ($answer -ne 's') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Avvio 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 completato"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download fallito >_<... Il seguente è il log:"
                    Write-Output ''

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

        }
  
        Write-Output "Avvio tentativo di pulizia dei vecchi file di backup..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Eliminazione vecchio file di backup $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "Si è verificato un errore durante l'eliminazione del vecchio file di backup $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Puliti $count vecchi file di backup"
            Write-Output ''
        }
        else {
            Write-Output 'Nessun vecchio file di backup da pulire'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}
Salva questo script come scriptname.ps1 nel percorso in cui desideri scaricare il backup. Prova “Esegui con Powershell”. Se ha successo, puoi procedere al passo successivo.

Per pianificare un’attività

Cerca “Utilità di pianificazione”.

Fai doppio clic su Aggiungi attività pianificata. Appare la procedura guidata per l’utilità di pianificazione.

Fai clic su Avanti, quindi fai clic su Sfoglia. Appare la finestra di dialogo Seleziona programma da pianificare.

Naviga fino allo script che hai creato, fai clic su di esso, quindi su Apri. Si torna alla procedura guidata per l’utilità di pianificazione.

Fornisci un nome per l’attività, o mantieni quello predefinito, che è il nome del file, specifica ogni quanto eseguire lo script, quindi fai clic su Avanti.

Specifica l’ora e la data di inizio (se hai specificato Giornaliero, Settimanale, Mensile, ecc.) e la ricorrenza, quindi fai clic su Avanti. Questo elemento dovrebbe corrispondere al ciclo di backup automatico del tuo discourse

Digita il nome utente e la password per l’account che eseguirà lo script, quindi fai clic su Avanti.

Se desideri configurare proprietà avanzate, seleziona la casella di controllo, quindi fai clic su Fine.

@Canapin con l’applicazione di rebuild del launcher, non deve essere eseguito come

./launcher r build app

Questo è solo il modo in cui ho sempre usato eseguirlo da altri documenti qui sul sito. Come ho imparato, ci sono spesso molti modi per fare le cose. Lol

Bella descrizione, utile.

NateDhaliwal · 28 Dicembre 2025, 12:56am

Ma dato che prima faresti cd /var/discourse, ./ si riferirebbe solo a quella directory, quindi il percorso di launcher è essenzialmente /var/discourse/launcher, no?

Heliosurge · 28 Dicembre 2025, 3:58am

Non ne ero a conoscenza. L’ho appena usato come da altri tutorial su Discourse. Ma ha senso. Grazie

Ed_S · 28 Dicembre 2025, 6:01am

Mi chiedo se valga la pena aggiungere alcuni suggerimenti per l’escalation? Se la persona che legge il documento non sa come connettersi via ssh all’host, per indagare o risolvere, chi può? Forse un suggerimento per fare domande qui sul meta, forse anche un suggerimento per usare ask.

Jonathan5 · 28 Dicembre 2025, 11:42pm

È una buona notizia. Sapevo solo come scaricare il backup creato dal forum stesso.

Canapin · 29 Dicembre 2025, 2:09pm

Grazie per il tuo aiuto!

Ho aggiunto questo all’inizio della mia guida:

Assicurati di essere preparato per ogni situazione

È fortemente consigliato, oltre ai backup locali (salvati sullo stesso server del forum), di avere una copia di questi backup su un altro server o nel cloud^[1].

È anche utile conservare una copia del file /var/discourse/containers/app.yml in un luogo sicuro^[2]. Questo file opzionale viene utilizzato in caso di reinstallazione del forum o di migrazione su un altro server.

In caso di dubbi seri su qualsiasi cosa, contattami (canapin@gmail.com).

Ho aggiunto questo nella sezione aggiornamento:

Prima di effettuare un aggiornamento, è fortemente consigliato scaricare l’ultimo backup del tuo forum.

Ho aggiunto questo:

Cosa fare se il forum non funziona più?

La ricostruzione del forum risolve molti problemi e viene eseguita con lo stesso comando di un aggiornamento da riga di comando:
/var/discourse/launcher rebuild app
E se il forum non funziona ancora dopo una ricostruzione?

Chiedi a me (canapin@gmail.com) o pubblica sul forum di supporto ufficiale.

Ho anche menzionato ask.discourse.org alla fine della guida.

Risorse

https://meta.discourse.org : supporto ufficiale, non esitare a pubblicare lì — i membri della community e gli sviluppatori sono molto disponibili
https://ask.discourse.com : un chatbot addestrato sul supporto e sui dati di Discourse, sorprendentemente efficace nel rispondere alle domande (sì, davvero)

Testo completo

Assicurati di essere preparato per ogni situazione

È fortemente consigliato, oltre ai backup locali (salvati sullo stesso server del forum), di avere una copia di questi backup su un altro server o nel cloud^[1:1].

È anche utile conservare una copia del file /var/discourse/containers/app.yml in un luogo sicuro^[2:1]. Questo file opzionale viene utilizzato in caso di reinstallazione del forum o di migrazione su un altro server.

In caso di dubbi seri su qualsiasi cosa, contattami (canapin@gmail.com).

Aggiornamenti

Prima di effettuare un aggiornamento, è fortemente consigliato scaricare l’ultimo backup del tuo forum.

Tramite l’interfaccia

Esegui gli aggiornamenti quando c’è una faccina rossa infelice nell’amministrazione (significa che c’è un aggiornamento importante da fare).
Gli aggiornamenti vengono eseguiti tramite https://tuo-forum.com/admin/upgrade

A volte vengono eseguiti in due fasi: potresti prima dover aggiornare “Docker_Manager” prima di poter aggiornare il resto:

Tramite riga di comando

A volte, un aggiornamento deve essere eseguito tramite riga di comando (la pagina di amministrazione di Discourse lo indicherà se necessario).

Connettiti al server tramite SSH
Ricostruisci il forum (una ricostruzione aggiorna sempre Discourse) usando il seguente comando:
```
/var/discourse/launcher rebuild app
```
Di tanto in tanto, dopo esserti assicurato che il forum funzioni correttamente, può essere utile rimuovere le immagini Docker inutilizzate (avanzi di aggiornamenti precedenti) per liberare spazio su disco:
```
/var/discourse/launcher cleanup
```

Cosa fare se il forum non funziona più?

La ricostruzione del forum risolve molti problemi e viene eseguita con lo stesso comando di un aggiornamento da riga di comando:

/var/discourse/launcher rebuild app

Penso che sia abbastanza buono ora e che non mi manchi nulla di importante

Se ho installato il tuo forum, i tuoi backup vengono copiati automaticamente sul mio Google Drive, ma idealmente in futuro dovrebbero essere salvati su uno spazio di cui sei responsabile. Ne parleremo un giorno ↩︎ ↩︎
Contiene il nome utente e la password del server di posta, nonché l’email dell’amministratore di primo livello (la mia, in realtà). ↩︎ ↩︎

Jonathan5 · 29 Dicembre 2025, 6:52pm

Se questo funziona, sarebbe una raccomandazione migliore (più semplice) rispetto alla solita versione a due righe (che prima erano tre, quindi possiamo continuare il trend).

merefield · 29 Dicembre 2025, 7:16pm

Entrambi funzionano.

Se ti trovi nella directory ./ è richiesto perché la posizione del lanciatore non è nel percorso (path).

Linux richiede che se un comando non è nel percorso, gli si fornisca il suo percorso completo in modo che non ci possano essere errori su quale file si intendeva.

merefield · 29 Dicembre 2025, 7:19pm

Sì, ma spesso potresti fare più cose, ad esempio prima una pulizia. In tal caso, eseguire prima il cd potrebbe risultare più breve.

Andrew_Rowe · 30 Dicembre 2025, 2:27am

Sono d’accordo e ho salvato l’argomento tra i preferiti per un uso futuro, grazie

Canapin · 30 Dicembre 2025, 4:17pm

Ecco quindi la guida completa tradotta automaticamente:

Assicurarsi di essere preparati per ogni evenienza

È fortemente consigliato, oltre ai backup locali (memorizzati sullo stesso server del forum), di avere una copia di tali backup su un altro server o nel cloud^[1].

È anche utile conservare una copia del file /var/discourse/containers/app.yml in un luogo sicuro^[2]. Questo file opzionale è utile in caso di reinstallazione del forum o migrazione su un altro server.

~~Se hai dubbi seri su qualcosa, contattami.~~

Aggiornamenti

Prima di effettuare un aggiornamento, è fortemente consigliato scaricare l’ultimo backup del tuo forum.

Tramite l’interfaccia

Esegui gli aggiornamenti quando c’è una faccina rossa triste nell’amministrazione (significa che c’è un aggiornamento importante da fare).
Gli aggiornamenti si effettuano tramite https://tonforum.fr/admin/upgrade

A volte avvengono in due fasi: devi prima aggiornare “Docker_Manager” prima di poter aggiornare il resto:

Tramite riga di comando

A volte un aggiornamento deve essere eseguito tramite riga di comando (la pagina di amministrazione di Discourse lo indicherà se necessario).

Connettiti al server tramite SSH
Ricostruisci il forum (una ricostruzione aggiorna sempre Discourse) usando il seguente comando:
```
/var/discourse/launcher rebuild app
```
Di tanto in tanto, dopo esserti assicurato che il forum funzioni correttamente, può essere utile rimuovere le immagini Docker inutilizzate (avanzi di aggiornamenti precedenti) per liberare spazio su disco:
```
/var/discourse/launcher cleanup
```

Cosa fare se il forum non funziona più?

Ricostruire il forum risolve molti problemi e si esegue con lo stesso comando di un aggiornamento tramite riga di comando:

/var/discourse/launcher rebuild app

E se il forum ancora non funziona dopo una ricostruzione?

~~Chiedi a me o~~ pubblica sul forum di supporto ufficiale.

Posizione dei file importanti sul server

`app.yml`

Contiene la configurazione del server e l’elenco dei plugin installati. Molto utile se il forum deve essere spostato su un altro server, o per alcune configurazioni (spostare caricamenti e backup su un altro disco, ad esempio). Si trova qui:

/var/discourse/containers/app.yml

`mail-receiver.yml`

Contiene la configurazione del software che consente di ricevere e pubblicare sul forum le risposte via email. Si trova qui:

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

Backup

I file di backup si trovano qui:

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

Pagine importanti nell’amministrazione del forum:

Pagine che possono essere utili

Temi e componenti

Contengono, tra le altre cose, CSS e HTML personalizzati:

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

Log

Email

Utile per il debug:

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

Azioni dello staff

Molto utile. Mantiene una registrazione di (quasi) tutte le modifiche alle impostazioni del sito e altre azioni di moderatori e amministratori.

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

Log degli errori

Può fornire indizi quando c’è un problema la cui causa non è ovvia.

https://tonforum.fr/logs/

Backup

Per modificare la frequenza e il numero massimo dei backup, visualizzarli o scaricarli:

https://tonforum.fr/admin/backups

Risorse

https://meta.discourse.org : supporto ufficiale, non esitare a pubblicare lì, membri e sviluppatori sono felici di aiutare
https://ask.discourse.com : un chatbot addestrato sul supporto e sui dati di Discourse, sorprendentemente efficace nel rispondere alle domande (sì, davvero)

Se ho installato il tuo forum, i tuoi backup vengono copiati automaticamente sul mio Google Drive, ma idealmente in futuro dovrebbero essere salvati in uno spazio di cui sei responsabile. Ne parleremo un giorno ↩︎
Contiene l’identificativo e la password per il server di posta, nonché l’email amministratore ~~(la mia, in realtà)~~. ↩︎

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

Sto scrivendo una breve documentazione per gli admin dei forum Discourse che ho aiutato a configurare. Mi manca qualcosa?

Aggiornamenti

Tramite l’interfaccia web

Tramite riga di comando

Posizione dei file importanti sul server

app.yml

mail-receiver.yml

Backup

Pagine importanti nell’amministrazione del forum

Temi e componenti

Log

Email

Azioni dello staff

Log degli errori

Backup

Risorse

Assicurati di essere preparato per ogni situazione

Cosa fare se il forum non funziona più?

E se il forum non funziona ancora dopo una ricostruzione?

Risorse

Assicurati di essere preparato per ogni situazione

Aggiornamenti

Tramite l’interfaccia

Tramite riga di comando

Cosa fare se il forum non funziona più?

Assicurarsi di essere preparati per ogni evenienza

Aggiornamenti

Tramite l’interfaccia

Tramite riga di comando

Cosa fare se il forum non funziona più?

E se il forum ancora non funziona dopo una ricostruzione?

Posizione dei file importanti sul server

app.yml

mail-receiver.yml

Backup

Pagine importanti nell’amministrazione del forum:

Temi e componenti

Log

Email

Azioni dello staff

Log degli errori

Backup

Risorse

Argomenti correlati

`app.yml`

`mail-receiver.yml`

`app.yml`

`mail-receiver.yml`