Get the most out of your Centmin Mod LEMP stack
Become a Member

Nginx 1.23 Compatibility Status

Discussion in 'Centmin Mod News' started by eva2000, Sep 3, 2022.

Thread Status:
Not open for further replies.
  1. eva2000

    eva2000 Administrator Staff Member

    May 24, 2014
    Brisbane, Australia
    Local Time:
    11:46 AM
    Nginx 1.21.x
    MariaDB 10.x
    Centmin Mod Nginx has always defaulted to using Nginx mainline branches which are the odd version numbers like 1.19, 1.21, and 1.23. While Nginx stable branches are even numbers like 1.18, 1.20, and 1.22.

    Nginx mainline branches get the more frequent bugs and all security fixes and new features are added frequently. While Nginx stable branches do not get new features and only critical security fixes and only get the backported major features/security fixes once a year from the Nginx mainline branches. So Nginx 1.22 stable branch got all the new features and security fixes from the previous Nginx 1.21 mainline branch.

    Nginx 1.23 Compatibility Status

    Nginx 1.23 mainline branch was released on June 21 2022, with previous version compatibility breaking changes which meant some Nginx modules like ngx_https_redis, srcache-nginx-module, headers-more-nginx-module and ngx_pagespeed ended up broken and needing updates for Nginx 1.23 compatibility.

    As such for Centmin Mod Nginx builds, I made an initial update in the current updated Centmin Mod 124.00stable and 130.00beta01 releases to block users from upgrading to Nginx 1.23 via menu option 4 with NGINX_ONETWOTHREE_COMPAT='n' variable while I waited on these Nginx module's respective developers to work on compatibility updates for Nginx 1.23. This then allowed me and users to test and enable Nginx 1.23 branch updates with NGINX_ONETWOTHREE_COMPAT='y' variable set in persistent config file /etc/centminmod/ prior to menu option 4 runs - which will unblock Nginx 1.23 updates.

    Eventually, most Nginx modules that were broken did get compatibility updates for Nginx 1.23. However, I have kept the default NGINX_ONETWOTHREE_COMPAT='n' in place to see the long-term impacts of these updates and changes.

    Folks can also help test Nginx 1.23 by setting NGINX_ONETWOTHREE_COMPAT='y' variable in persistent config file /etc/centminmod/ prior to menu option 4 Nginx upgrade runs and report any issues they may have.

    Broken Nginx 1.23 Modules

    Unfortunately, one Nginx module that didn't get updated was ngx_pagespeed module. As such I updated Centmin Mod 124.00stable and 130.00beta01 to disable ngx_pagespeed module altogether until an update is available at least.

    Older Centmin Mod Versions' Nginx 1.23 Compatibility

    If you're still on older Centmin Mod 123.08stable or 123.09beta01, they are now effectively broken for Nginx 1.23 as they do not get any more updates. Folks using these versions should update to either Centmin Mod 124.00stable or 130.00beta01.
    Last edited: Sep 4, 2022
Thread Status:
Not open for further replies.