Log Entry: Download exceeded maximum size

Your question

I keep seeing this entry in my Logs:
listenerId = “http”, localPort = 8080, remoteIp = 172.20.0.1, remotePort = 59592, details = “Download exceeded maximum size”

However I’m unable to isolate what is trying to be downloaded, what configuration option controls the download size limitation. It doesn’t appear to be related to Geolocation data.

I understand that topics in this category are triaged by a bot first but a human reply will follow up. If I’d prefer a human-only reply, I’ll add the no-ai tag to my topic.

on

The log message "Download exceeded maximum size" is triggered specifically when Stalwart tries to fetch a logo image (for a domain or tenant in the Enterprise Edition multi-tenancy feature) and the response body exceeds 1 MB (MAX_IMAGE_SIZE = 1024 * 1024 bytes, hardcoded in the source).

This is not a configurable limit – it is hardcoded as a safety cap on downloaded logo images. The request is coming in on your HTTP listener (port 8080), which causes a logo fetch from an external URL configured on a domain or tenant object, and that remote image is larger than 1 MB.

To resolve this, check the logo URL(s) configured on your domain(s) or tenant(s) in the WebUI (Settings > Domains or Tenants) and either:

  • Replace the configured logo URL with one that serves an image under 1 MB in size, or
  • Remove the logo URL entirely if it’s not needed.

The 172.20.0.1 source IP (a Docker bridge address) suggests the request is coming from a local service or reverse proxy, which would be consistent with a WebUI or client triggering a logo lookup for a login page.

This is an automated reply from the Stalwart Help Bot. Other community members may follow up if this answer is incomplete or wrong. If you found it useful, mention @helpbot in any reply to ask follow-up questions and the bot will respond again.

@helpbot
What is the recomended pixel dimension to use for the custom Logo image?

The documentation does not specify a recommended pixel dimension for the custom logo image. The only hard constraint documented in the source code is the 1 MB file size cap mentioned in the previous reply.

For practical guidance, SVG format is a natural choice since it is resolution-independent and typically very small in file size. If you use a raster format (PNG/JPEG), a width in the range of 200-400px at a reasonable resolution is typical for WebUI logos, but this is not specified by Stalwart’s docs.

You can also supply the logo as a base64-encoded image directly in the logo field on the Domain or Tenant object, rather than a URL, which avoids any external fetch entirely.

For the branding documentation, see: Branding | Stalwart

This is an automated reply from the Stalwart Help Bot. Other community members may follow up if this answer is incomplete or wrong. If you found it useful, mention @helpbot in any reply to ask follow-up questions and the bot will respond again.

The bot reply is correct overall.

It seems you have to remove the config.toml in the /etc/stalwart directory as well, then it fully resets.