nginx-proxy-manager

Nginx Proxy Manager: Simplifying Reverse Proxy Management

Nginx Proxy Manager is a user-friendly solution designed to make managing reverse proxy tasks a breeze. It packages the powerful Nginx web server into an easy-to-use platform, complete with free SSL from Let's Encrypt, making it accessible even to those with minimal technical knowledge.

Project Goal

The main objective of Nginx Proxy Manager is to simplify the process of setting up a reverse proxy with SSL termination so that anyone, regardless of their technical expertise, can use it. Advanced features are available but entirely optional, ensuring that the tool remains straightforward for all users.

Features

Nginx Proxy Manager boasts a variety of features:

• Intuitive Admin Interface: Utilizes the sleek and secure Tabler interface.
• Effortless Setup: Users can quickly create forwarding domains, redirections, streams, and even 404 hosts without diving into the complexities of Nginx.
• SSL Certificates: Offers free SSL through Let's Encrypt, or users can apply their own custom certificates.
• Security and Access Control: Includes access lists and basic HTTP authentication for enhanced security.
• Advanced Configurations: For more experienced users, there is the ability to configure Nginx settings in greater depth.
• User Management: Provides tools for managing users, assigning permissions, and maintaining an audit log.

Hosting Your Home Network

Setting up your home network with Nginx Proxy Manager involves several straightforward steps:

1. Use the port forwarding feature on your home router for ports 80 and 443 to connect to your server.
2. Configure your domain to point to your home network, using either a static IP or a dynamic DNS service like DuckDNS or Amazon Route53.
3. Set Nginx Proxy Manager as your entry point to manage and forward your internet services.

Quick Setup Guide

To quickly deploy Nginx Proxy Manager, follow these steps:

1. Install Docker and Docker-Compose: Refer to their official documentation for installation instructions.
2. Create docker-compose.yml: Set up a configuration file to initiate the services.

   services:
     app:
       image: 'docker.io/jc21/nginx-proxy-manager:latest'
       restart: unless-stopped
       ports:
         - '80:80'
         - '81:81'
         - '443:443'
       volumes:
         - ./data:/data
         - ./letsencrypt:/etc/letsencrypt
   

3. Launch the Stack: Run docker-compose up -d to start your Nginx Proxy Manager instance.
4. Access the Admin Interface: Once the container is operational, access the interface through http://127.0.0.1:81 using the default login credentials:
   • Email: [email protected]
   • Password: changeme Remember to change these credentials post-login.

Contributing to the Project

Contributions are encouraged, with pull requests expected to target the develop branch. Successful pull requests undergo CI checks before being merged into the main branch. Contributors can view the developing documentation available for preview.

Community and Support

For support, users can report bugs, participate in discussions, or join the community forum on Reddit, engaging with other enthusiasts and developers.

Nginx Proxy Manager isn't just a tool; it's a community-friendly platform, designed with simplicity at its core, to make reverse proxy management accessible to everyone.