Change the maximum attachment/upload size

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

:person_raising_hand: 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.
  1. Edit the configuration file:
  • Navigate to the configuration directory and edit the app.yml file:
cd /var/discourse/
nano containers/app.yml
  1. 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
  1. Save your changes:
  • Press Ctrl+X to exit, then Y to confirm, and Enter to save the changes.
  1. Rebuild the Discourse instance:
  • Run the following command from the /var/discourse directory:
./launcher rebuild app
  1. Update site settings:
  • Go to /admin/site_settings/category/files in your Discourse dashboard.
  • Adjust the max attachment size kb to 20480 (for 20 MB) or your preferred size.

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

Check documentPerform check on document:
62 curtidas

Por que a mensagem de erro está incorreta? Aqui está minha mensagem de erro.

Ao tentar carregar um arquivo de 10 MB. A mensagem de erro está incorreta.

3 curtidas

Que tipo de arquivo era? Você consegue fazer upload de outros arquivos para esse site?

Às vezes, ocorrem problemas no navegador durante o processo de upload que causam problemas temporários. Tente fazer o upload do seu arquivo novamente, em uma nova sessão do navegador.

2 curtidas

Este artigo não é atualizado há muito tempo? Por que não consigo encontrar "upload_size: 20m"???

2 curtidas

A primeira postagem foi atualizada há 5 dias

O guia diz que você precisa adicionar essa linha. Portanto, antes de adicioná-la, você não a encontrará. Adicionei alguma formatação na citação abaixo. Isso ajuda você?

9 curtidas

isso também afeta a configuração do tamanho máximo da imagem em KB?

1 curtida

Sim, isso afeta qualquer tipo de upload.

Mais especificamente, acredito que a configuração upload_size do app.yml é fornecida ao nginx como client_max_body_size, que é o mesmo parâmetro fornecido nas descrições das duas configurações do site:

Tamanho máximo de imagem KB O tamanho máximo de upload de imagem. Isso também deve ser configurado no nginx (client_max_body_size) / apache ou proxy. Imagens maiores que este e menores que client_max_body_size serão redimensionadas para caber no upload.
Tamanho máximo de anexo KB O tamanho máximo de upload de arquivos de anexo. Isso também deve ser configurado no nginx (client_max_body_size) / apache ou proxy.
4 curtidas

Esta configuração agora permite a entrada direta de MB:

image

Talvez a configuração precise de um novo nome e o texto acima atualizado?

A menos que algo tenha mudado, o que essa alteração no yml faz é mudar o tamanho máximo que o Discourse permite. Ou seja, o tamanho máximo disponível na ux é de 10 MB. Isso permite que você aumente esse máximo alterando algumas coisas nos arquivos de configuração do nginx.

O que eu quis dizer foi que você não precisa mais inserir kb nas configurações do site - não que a funcionalidade tenha mudado.

Embora seria bom se as configurações do site simplesmente refletissem o que estava no YML sem a necessidade de uma configuração separada.

1 curtida

Eu acho que, embora a entrada do usuário permita usar MB também, o valor é sempre salvo em KB.

Para mim, os nomes das configurações não são informações para o usuário, mas sim um termo técnico para identificar a configuração. Eles não são traduzíveis, então administradores que usam o Discourse em um idioma diferente não necessariamente os entenderão. E a configuração do Discourse também deve funcionar para eles. Portanto, a descrição precisa ser boa o suficiente por si só.
Talvez usuários que falam inglês também devessem usar essa perspectiva e ignorar o nome da configuração, focando mais na descrição. Assim, você não ficaria confuso com o nome.

1 curtida

Mas você pode, digamos, ter uma instância multissite e alguns sites querem menos do que o máximo teórico. Essa é pelo menos parte da razão pela qual existem duas configurações.

1 curtida

Que tal melhorarmos o texto da descrição para essa configuração e adicionarmos um link para este Tópico nela?

Acho que isso tornaria as coisas melhores para todos.

1 curtida