Change the maximum attachment/upload size

[Discourse]

This guide explains how to change the maximum attachment upload size for self-hosted Discourse instances.

Required user level: System Admin

The default attachment upload size limit is 10MB

If you are self-hosting Discourse and need to allow uploads larger than 10 MB, follow the steps below.

Changing the upload size

1. Connect to your server:

• Use SSH to access your server’s command line interface.

2. Edit the configuration file:

• Navigate to the configuration directory and edit the app.yml file:

cd /var/discourse/
nano containers/app.yml

3. Modify the upload parameters:

• Look for the section labeled params. Directly below, add your desired upload size with careful attention to formatting:

params:
  ## Which Git revision should this container use? (default: latest)
  version: latest
  ## Maximum upload size (default: 10m)
  upload_size: 20m

4. Save your changes:

• Press Ctrl+X to exit, then Y to confirm, and Enter to save the changes.

5. Rebuild the Discourse instance:

• Run the following command from the /var/discourse directory:

./launcher rebuild app

6. Update site settings:

• Go to /admin/site_settings/category/files in your Discourse dashboard.
• Adjust max attachment size kb and max image size kb to your preferred size (e.g. 20 MB). The setting UI allows you to enter the value and select a unit (KB, MB, or GB) from the dropdown.

Both settings are capped by the nginx client_max_body_size value, which is controlled by the upload_size param you set in step 3. The site settings cannot exceed this limit.

Last edited by @david 2025-09-29T13:05:48Z

Check document

Perform check on document:

[bar10dr]

Perché il messaggio di errore non è corretto? Ecco il mio messaggio di errore.

Mentre tentavo di caricare un file da 10 MB. Il messaggio di errore non è corretto.

[maiki]

Che tipo di file era? Riesci a caricare altri file su quel sito?

A volte ci sono problemi del browser durante il processo di caricamento che causano problemi temporanei. Prova a caricare nuovamente il tuo file, in una nuova sessione del browser.

[qianping_chen (rouin)]

Questo articolo non viene aggiornato da molto tempo? Perché non riesco a trovare “upload_size: 20m”???

[Moin]

@qianping_chen

Questo articolo non viene aggiornato da molto tempo?

Il primo post è stato aggiornato 5 giorni fa

@qianping_chen

Perché non riesco a trovare “upload_size: 20m”?

La guida dice che devi aggiungere quella riga. Quindi, prima di aggiungerla, non la troverai. Ho aggiunto della formattazione nella citazione qui sotto. Ti aiuta?

@Discourse

3. Modifica i parametri di caricamento:

• Cerca la sezione etichettata params. Subito sotto, aggiungi la dimensione di caricamento desiderata prestando particolare attenzione alla formattazione:

params:
  ## Quale revisione Git dovrebbe usare questo container? (default: tests-passed)
  version: tests-passed
+ ## Dimensione massima di caricamento (default: 10m)
+ upload_size: 20m

[th21]

influisce anche sull’impostazione della dimensione massima dell’immagine in KB?

[Canapin (Coin-coin le Canapin)]

Sì, influisce su qualsiasi tipo di caricamento.

Più specificamente, credo che l’impostazione upload_size di app.yml venga fornita a nginx come client_max_body_size, che è lo stesso parametro fornito nelle descrizioni delle due impostazioni del sito:

Dimensione massima immagine KB	La dimensione massima di caricamento delle immagini. Deve essere configurata anche in nginx (client_max_body_size) / apache o proxy. Le immagini più grandi di questa e più piccole di client_max_body_size verranno ridimensionate per adattarsi al momento del caricamento.
Dimensione massima allegato KB	La dimensione massima di caricamento dei file allegati. Deve essere configurata anche in nginx (client_max_body_size) / apache o proxy.

[nathank (Nathan Kershaw)]

@Discourse

Regola max attachment size kb su 20480 (per 20 MB) o sulla dimensione preferita.

Questa impostazione ora consente l’inserimento diretto di MB:

Forse l’impostazione necessita di un cambio di nome e il testo sopra aggiornato?

[pfaffman (Jay Pfaffman)]

@nathank

Questa impostazione ora consente l’inserimento diretto di MB

A meno che qualcosa non sia cambiato, ciò che questa modifica allo yml fa è cambiare la dimensione massima consentita da Discourse. Cioè, la dimensione massima disponibile nell’interfaccia utente è 10 MB. Questo ti consente di aumentare tale massimo modificando alcune cose nei file di configurazione di nginx.

[nathank (Nathan Kershaw)]

Quello che intendevo era che non è più necessario inserire kb nelle impostazioni del sito, non che la funzionalità sia cambiata.

Anche se sarebbe bello se le impostazioni del sito riflettessero semplicemente ciò che è nello YML senza la necessità di un’impostazione separata.

[Moin]

@nathank

Quello che intendevo era che non è più necessario inserire kb nelle impostazioni del sito, non che la funzionalità sia cambiata.

Penso che mentre l’input dell’utente consente di utilizzare anche MB, il valore viene sempre salvato in KB.

Per me, i nomi delle impostazioni non sono informazioni per l’utente, ma più un termine tecnico per identificare l’impostazione. Non sono traducibili, quindi gli amministratori che utilizzano Discourse in una lingua diversa non li capiranno necessariamente. E la configurazione di Discourse dovrebbe funzionare anche per loro. Quindi la descrizione deve essere sufficientemente chiara di per sé.
Forse anche gli utenti di lingua inglese dovrebbero adottare quella prospettiva e ignorare il nome dell’impostazione, concentrandosi maggiormente sulla descrizione. In questo modo non sareste confusi dal nome.

[pfaffman (Jay Pfaffman)]

@nathank

Anche se sarebbe bello se l’impostazione del sito riflettesse semplicemente ciò che è nello YML senza la necessità di un’impostazione separata.

Ma potresti, diciamo, avere un’istanza multisito e alcuni siti desiderano meno del massimo teorico. Questo è almeno in parte il motivo per cui ci sono due impostazioni.

[nathank (Nathan Kershaw)]

@Moin

Forse anche gli utenti di lingua inglese dovrebbero usare quella prospettiva e ignorare il nome dell’impostazione, concentrandosi maggiormente sulla descrizione. Allora non saresti confuso dal nome.

Che ne dici se miglioriamo il testo della descrizione per quell’impostazione e vi inseriamo un link a questo argomento?
Penso che ciò migliorerebbe le cose per tutti.