Skip to content

[Bug]: Invalid parameter must-revalidate in gzip_proxied directive (nginx.conf line 11) #18

@brazeiro63

Description

@brazeiro63

Prerequisites

  • I have searched existing issues to ensure this bug hasn't been reported before
  • I have read the documentation
  • I am using a supported version of Evolution Manager

Bug Description

Description

There is an invalid configuration value in the nginx.conf file under the “Gzip compression” section. On line 11 the directive gzip_proxied currently includes must-revalidate as one of its parameters:

However, according to the official Nginx documentation for the gzip_proxied directive, the valid values are:
off, expired, no-cache, no-store, private, no_last_modified, no_etag, auth, any. :contentReference[oaicite:1]{index=1}
The value must-revalidate is not listed and thus causes the error observed:

Impact

  • Nginx fails to start or becomes stuck in the “Starting” state due to this invalid directive, preventing proper compression and serving of content.
  • Compression behaviour may not apply as intended for proxied responses, which may affect performance or caching behaviour.
  • It introduces configuration drift and potential confusion, since must-revalidate is a valid HTTP Cache-Control directive but not valid in the context of gzip_proxied.

Suggested Fix

To fix this issue, the must-revalidate parameter should be removed from the gzip_proxied directive. For example, update line 11 to something like:

Steps to Reproduce

  1. Pull or build the evolution-api stack, which uses evolution-manager-v2 and the evolution_frontend container.
  2. Deploy it via Docker (for example docker run, docker compose up, or similar).
  3. The evolution_frontend container attempts to start.
  4. In its logs you see an error like:
    invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
  5. Because of this invalid directive in nginx.conf (line 11) the Nginx process fails to start properly and the container stays in a Starting or Crash / Restart state instead of reaching Running.

Expected Behavior

Container evolution_frontend shoould start.

Actual Behavior

Because of this invalid directive in nginx.conf (line 11) the Nginx process fails to start properly and the container stays in a Starting or Crash / Restart state instead of reaching Running.

Screenshots

No response

Browser

Chrome

Browser Version

141.0.7390.123

Evolution Manager Version

v2.0.0

Evolution API Version

latest

Operating System

Windows

Console Logs

2025-11-02 11:27:32


Starting Evolution Manager v2...
2025-11-02 11:27:36 Starting Evolution Manager v2...
2025-11-02 11:27:25 
2025/11/02 14:27:25 [emerg] 6#6: invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
2025-11-02 11:27:25 nginx: [emerg] invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
2025-11-02 11:27:26 2025/11/02 14:27:26 [emerg] 7#7: invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11


nginx: [emerg] invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
2025-11-02 11:27:27


2025/11/02 14:27:27 [emerg] 6#6: invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
2025-11-02 11:27:27


nginx: [emerg] invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11

Additional Context

No response

Contribution

  • I would like to work on fixing this bug

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions