How to Update Nginx Proxy Manager 2.15: Complete Guide

Nginx Proxy Manager 2.15 is a significant maintenance update for this Docker-based reverse proxy management tool, widely used to simplify the configuration and management of reverse proxies. This update introduces a new Debian 13 "Trixie" base image and a series of improvements that make it particularly useful for system administrators and developers who need advanced control over their web services.

The update is fundamental for those managing public deployments, thanks to the OpenResty update that fixes several security vulnerabilities. Additionally, it improves SSL certificate management via Certbot, adding new plugins for various DNS providers and fixing a security issue related to role management.

This tool is particularly useful for those who need an intuitive user interface to configure reverse proxies without manually writing Nginx configuration files. It is ideal for those managing multiple domains and needing automatic SSL certificates, offering a simple way to configure and maintain secure and efficient reverse proxies.

Prerequisites

• Hardware: A server or device compatible with Docker.
• Software: Docker installed and correctly configured.
• Software: Docker Compose (optional, but recommended for managing containers).
• Software: Nginx Proxy Manager version 2.15.0.
• Software: Certbot and the related DNS plugins for SSL certificate management.
• Software: A DNS client compatible with the supported plugins (hoster.by, RcodeZero, Hostinger, deSEC, EuroDNS).

PROCEDURE: Updating to Nginx Proxy Manager 2.15

By following this guide, you will correctly update Nginx Proxy Manager to version 2.15, benefiting from the latest security features and improvements.

• Log in to the server terminal where Nginx Proxy Manager is installed.
• Run the command to update the Docker image: docker pull jc21/nginx-proxy-manager:2.15.0
• Stop the running container: docker stop nginx-proxy-manager
• Start a new container with the updated image: docker run -d --name=nginx-proxy-manager --restart=unless-stopped -p 80:80 -p 443:443 -p 81:81 -v /path/to/data:/data -v /path/to/letsencrypt:/etc/letsencrypt jc21/nginx-proxy-manager:2.15.0
• Log in to the Nginx Proxy Manager web interface to confirm that the update was completed successfully.

Verification and Troubleshooting

At the end of this guide, you will be able to test the correct functioning of Nginx Proxy Manager 2.15 and resolve any configuration issues.

Functionality Test

• Certificate test: Verify that the SSL certificates have been correctly renewed. Check the "SSL Certificates" section in the administration panel.
• Access test: Ensure that all users can access their respective proxy hosts without issues.
• New features test: Verify that the new Certbot plugins for hoster.by, RcodeZero, and Hostinger are available and functional.

Troubleshooting

• DNS plugin issues: If you encounter issues with Certbot DNS plugins, ensure that all necessary dependencies are installed. Check the official documentation for any updates.
• User permissions: If users cannot access their proxy hosts, verify that roles have been correctly configured and that there are no permission issues.
• Failed updates: If the update does not go through, try manually pulling the Docker image with the 2.15.0 tag.
• Debian base issues: If you encounter issues related to the new Debian 13 "Trixie" base, consult the official changelog for further details and solutions.

For more details and support, visit the official changelog.

At the end of this guide, you will have understood the main new features introduced by Nginx Proxy Manager 2.15 and will be ready to plan the update of your environment.

Educational Summary

• The update to Debian 13 "Trixie" represents a significant change in the system base.
• The OpenResty update fixes critical vulnerabilities, essential for public implementations.
• Improvements in Certbot management, with new plugins and CI tests for DNS plugins.
• Security fixes for role management in multi-user environments.
• Minor improvements in the web interface, such as column sorting and confirmation dialogs.

Call to Practice

Before proceeding with the update, verify the compatibility of your DNS plugins and plan a test in a staging environment. For production environments, use the 2.15.0 tag instead of latest for more accurate version control.