Prerequisites
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
- Pull or build the evolution-api stack, which uses evolution-manager-v2 and the evolution_frontend container.
- Deploy it via Docker (for example docker run, docker compose up, or similar).
- The evolution_frontend container attempts to start.
- In its logs you see an error like:
invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
- 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
Prerequisites
Bug Description
Description
There is an invalid configuration value in the
nginx.conffile under the “Gzip compression” section. On line 11 the directivegzip_proxiedcurrently includesmust-revalidateas one of its parameters:However, according to the official Nginx documentation for the
gzip_proxieddirective, 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-revalidateis not listed and thus causes the error observed:Impact
must-revalidateis a valid HTTPCache-Controldirective but not valid in the context ofgzip_proxied.Suggested Fix
To fix this issue, the
must-revalidateparameter should be removed from thegzip_proxieddirective. For example, update line 11 to something like:Steps to Reproduce
invalid value "must-revalidate" in /etc/nginx/conf.d/nginx.conf:11
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
Additional Context
No response
Contribution