Skip to content

Remove dhparams.pem and update nginx configuration for improved security and compliance with Mozilla guidelines#197

Open
nemchik wants to merge 2 commits into3.23from
mozilla-updates
Open

Remove dhparams.pem and update nginx configuration for improved security and compliance with Mozilla guidelines#197
nemchik wants to merge 2 commits into3.23from
mozilla-updates

Conversation

@nemchik
Copy link
Copy Markdown
Member

@nemchik nemchik commented May 4, 2026

Ref: mozilla/ssl-config-generator#252
Ref: https://github.com/mozilla/ssl-config-generator/blob/858f8f74a4fd1293a3a7f5ab0c16eb1eb891393a/src/js/helpers/nginx.js#L65-L70

ssl_session_tickets has been changed in nginx so disabling is no longer needed or recommended.

Ref: https://github.com/mozilla/ssl-config-generator/blob/5325c35c365a080dd88975d99b08fac4f30858fa/README.md?plain=1#L103
Ref: https://github.com/mozilla/ssl-config-generator/blob/5325c35c365a080dd88975d99b08fac4f30858fa/src/js/helpers/nginx.js#L72-L77
Ref: https://github.com/mozilla/ssl-config-generator/blob/5325c35c365a080dd88975d99b08fac4f30858fa/src/js/state.js#L151

ssl_dhparam is no longer used as this ships only ECDHE ciphers and uses TLS 1.2 or higher

Additional security recommendations from Mozilla are now noted in comments and the file has been a little reorganized to reflect.

Notable changes:

Additional note:

/config/nginx/dhparams.pem is not removed from existing setups. If users update their conf, the file does nothing. If users delete /config/nginx/dhparams.pem and do not update their conf their setup will break and we should recommend updating their conf.

…ity and compliance with Mozilla guidelines

Signed-off-by: Eric Nemchik <eric@nemchik.com>
Copilot AI review requested due to automatic review settings May 4, 2026 17:38
@LinuxServer-CI LinuxServer-CI moved this to PRs Ready For Team Review in Issue & PR Tracker May 4, 2026
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the base image’s default Nginx TLS configuration to align with newer Mozilla SSL Config Generator guidance, removing legacy DH parameter handling and reorganizing the sample SSL config for clarity and modern recommendations.

Changes:

  • Removed DH parameter provisioning/downloading from init startup (and removed the bundled dhparams.pem).
  • Updated ssl.conf.sample to Mozilla guideline v6.0 output (ECDHE-only cipher list, updated curves, session settings, and reorganized header suggestions).
  • Updated the commented resolver example to use bracketed IPv6 literals.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File Description
root/etc/s6-overlay/s6-rc.d/init-nginx/run Removes DH params copy/download logic from first-start init.
root/defaults/nginx/ssl.conf.sample Refreshes Mozilla-based TLS recommendations and reorganizes security header commentary.
root/defaults/nginx/nginx.conf.sample Updates resolver example to proper IPv6 literal syntax.
root/defaults/nginx/dhparams.pem Removes the bundled DH parameters file.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread root/defaults/nginx/ssl.conf.sample Outdated
@LinuxServer-CI
Copy link
Copy Markdown
Contributor

I am a bot, here are the test results for this PR:
https://ci-tests.linuxserver.io/lspipepr/baseimage-nginx/3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a58e188d1078fd64e0b0757379eb3c3db962fa71-pr-197/index.html
https://ci-tests.linuxserver.io/lspipepr/baseimage-nginx/3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a58e188d1078fd64e0b0757379eb3c3db962fa71-pr-197/shellcheck-result.xml

Tag Passed
amd64-3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a58e188d1078fd64e0b0757379eb3c3db962fa71-pr-197
arm64v8-3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a58e188d1078fd64e0b0757379eb3c3db962fa71-pr-197

Comment thread root/defaults/nginx/nginx.conf.sample
@LinuxServer-CI LinuxServer-CI moved this from PRs Ready For Team Review to PRs in Issue & PR Tracker May 4, 2026
@nemchik nemchik requested a review from a team May 4, 2026 20:36
@LinuxServer-CI LinuxServer-CI moved this from PRs to PRs Ready For Team Review in Issue & PR Tracker May 4, 2026
@LinuxServer-CI LinuxServer-CI moved this from PRs Ready For Team Review to PRs in Issue & PR Tracker May 4, 2026
Signed-off-by: Eric Nemchik <eric@nemchik.com>
@LinuxServer-CI
Copy link
Copy Markdown
Contributor

I am a bot, here are the test results for this PR:
https://ci-tests.linuxserver.io/lspipepr/baseimage-nginx/3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a6cd315ad5e71a90c831b80f1a759121aaf1025f-pr-197/index.html
https://ci-tests.linuxserver.io/lspipepr/baseimage-nginx/3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a6cd315ad5e71a90c831b80f1a759121aaf1025f-pr-197/shellcheck-result.xml

Tag Passed
amd64-3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a6cd315ad5e71a90c831b80f1a759121aaf1025f-pr-197
arm64v8-3.23-1.28.3-r0_8.5.5-r1-pkg-60bb1d50-dev-a6cd315ad5e71a90c831b80f1a759121aaf1025f-pr-197

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

3 participants