File Upload Size Limits#

Squirro enforces a default 96 MB file upload limit via two settings that must be kept in sync:

  1. frontend.max-file-size

    Server configuration

  2. client_max_body_size

    Nginx proxy configuration

Modifying Upload Limits#

To increase the file upload limit:

  1. Update the frontend configuration

    Set frontend.max-file-size (in bytes) in the server configuration. This setting is managed through Squirro’s Configuration Service under the Server space.

  2. Update the nginx configuration

    Edit the nginx configuration file /etc/nginx/nginx.conf to set client_max_body_size and restart the nginx service.

    sudo nano /etc/nginx/nginx.conf
    
    sudo systemctl restart nginx
    

An important rule to follow is to ensure that the frontend.max-file-size value is set to be less than or equal to the client_max_body_size value.

Note

Custom asset uploads, such as ui_bundle deployments made with squirro_asset or neo-ui deploy, use a separate limit of 512 MB. That limit is set on the /api/topic/v0/<tenant>/assets/ location in /etc/nginx/conf.d/topic.conf and is not affected by the client_max_body_size value in /etc/nginx/nginx.conf. To change it, edit topic.conf and restart nginx.

Example Configuration#

To set a 200 MB upload limit, adjust the settings as follows:

  1. Frontend Configuration (via Configuration Service)

    frontend.max-file-size = 209715200
    
  2. Nginx Configuration

    client_max_body_size 200m;
    

Additional Considerations#

  • Datasource plugins

    They may have additional limits.

  • Large file timeouts

    Consider adjusting client_body_timeout in nginx for slow connections.

  • PDF conversion timeouts

    May need proxy_read_timeout adjustments for large PDF files.