Change the maximum attachment/upload size

Documentation Self-Hosting
1

: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: tests-passed)
  version: tests-passed
  ## 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 @SaraDev 2024-09-17T22:43:39Z

Check documentPerform check on document:
60 Likes
73

Why is the error message incorrect though? Here is my error message.

image
image848Ă—172 4.07 KB

While trying to upload a 10mb file. The error message is incorrect.

1 Like
74

What kind of file was it? Are you able to upload other files to that site?

Sometimes there are browser issues during the upload process that cause temporary issues. Please try uploading your file again, in a new browser session.

2 Likes
75

Has this article not been updated for a long time? Why can’t I find “upload_size: 20m”???

2 Likes
76

The first post was updated 5 days ago

Screenshot_20240923_124107_Firefox
Screenshot_20240923_124107_Firefox1212Ă—165 25.5 KB

The guide says you need to add that line. So, before adding it, you won’t find it. I added some formatting in the quote below. Does that help you?

6 Likes
77

does it also affect the max image size kb setting?

1 Like
78

Yes, it does affect any type of upload.

More specifically, I believe the upload_size app.yml setting is given to nginx as client_max_body_size, which is the same parameter provided in the two site settings descriptions:
Max image size KB The maximum image upload size. This must be configured in nginx (client_max_body_size) / apache or proxy as well. Images larger than this and smaller than client_max_body_size will be resized to fit on upload.
Max attachment size KB The maximum attachment files upload size. This must be configured in nginx (client_max_body_size) / apache or proxy as well.
2 Likes