Convert Figma logo to code with AI

NginxProxyManager logonginx-proxy-manager

Docker container for managing Nginx proxy hosts with a simple, powerful interface

21,968
2,532
21,968
1,457

Top Related Projects

Docker container for managing Nginx proxy hosts with a simple, powerful interface

Automated docker nginx proxy integrated with letsencrypt.

Automated nginx proxy for Docker containers using docker-gen

50,061

The Cloud Native Application Proxy

56,905

Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS

Quick Overview

Nginx Proxy Manager is a web-based application that simplifies the process of managing Nginx as a reverse proxy. It provides a user-friendly interface for configuring proxy hosts, SSL certificates, and access lists, making it easier for users to manage their web server setup without deep technical knowledge of Nginx configuration.

Pros

  • Easy-to-use web interface for managing Nginx proxy settings
  • Automated SSL certificate management with Let's Encrypt integration
  • Support for custom SSL certificates and access control lists
  • Docker-based deployment for easy installation and updates

Cons

  • Limited advanced Nginx configuration options compared to manual setup
  • Requires additional system resources due to its Docker-based nature
  • May not be suitable for highly complex or custom Nginx configurations
  • Potential security concerns if not properly configured or maintained

Getting Started

To get started with Nginx Proxy Manager, follow these steps:

  1. Ensure Docker and Docker Compose are installed on your system.
  2. Create a docker-compose.yml file with the following content:
version: '3'
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'
      - '81:81'
      - '443:443'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
  1. Run the following command to start the container:
docker-compose up -d
  1. Access the web interface at http://your-server-ip:81

  2. Log in with the default credentials:

    • Email: admin@example.com
    • Password: changeme
  3. Change the default admin password after logging in for the first time.

You can now start adding proxy hosts, managing SSL certificates, and configuring access lists through the web interface.

Competitor Comparisons

Docker container for managing Nginx proxy hosts with a simple, powerful interface

Pros of nginx-proxy-manager

  • User-friendly web interface for managing Nginx proxy configurations
  • Built-in SSL certificate management with Let's Encrypt integration
  • Docker-based deployment for easy installation and updates

Cons of nginx-proxy-manager

  • Limited advanced Nginx configuration options compared to manual setup
  • Potential performance overhead due to additional layers (Node.js backend)
  • Dependency on external services for some features (e.g., Let's Encrypt)

Code Comparison

Both repositories contain the same codebase, as they are identical. Here's a sample of the Nginx configuration generated by nginx-proxy-manager:

server {
    listen 80;
    server_name example.com;
    location / {
        proxy_pass http://backend;
        proxy_set_header Host $host;
    }
}

This configuration is automatically generated based on user input through the web interface, simplifying the process of setting up reverse proxies and SSL certificates.

Summary

nginx-proxy-manager provides a user-friendly solution for managing Nginx proxy configurations, making it accessible to users with less technical expertise. However, it may not be suitable for advanced users who require fine-grained control over Nginx settings. The project's focus on simplicity and ease of use comes at the cost of some flexibility and potential performance trade-offs.

Automated docker nginx proxy integrated with letsencrypt.

Pros of nginx-proxy-automation

  • Lightweight and simple setup, focusing on core proxy functionality
  • Integrates well with Docker Compose environments
  • Automatic container discovery and configuration

Cons of nginx-proxy-automation

  • Lacks a user-friendly web interface for management
  • Limited built-in features compared to nginx-proxy-manager
  • May require more manual configuration for advanced setups

Code Comparison

nginx-proxy-automation:

version: '3'
services:
  nginx-proxy:
    image: jwilder/nginx-proxy
    ports:
      - "80:80"
      - "443:443"

nginx-proxy-manager:

version: '3'
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    ports:
      - '80:80'
      - '81:81'
      - '443:443'

nginx-proxy-automation focuses on a streamlined approach, using the jwilder/nginx-proxy image for core functionality. nginx-proxy-manager, on the other hand, provides a more comprehensive solution with an additional management interface on port 81.

While nginx-proxy-automation excels in simplicity and Docker integration, nginx-proxy-manager offers a more user-friendly experience with its web-based management interface. The choice between the two depends on the user's needs for simplicity versus advanced features and ease of management.

Automated nginx proxy for Docker containers using docker-gen

Pros of nginx-proxy

  • Lightweight and efficient, with minimal overhead
  • Automatic container discovery and configuration
  • Supports multiple networks and complex setups

Cons of nginx-proxy

  • Lacks a user-friendly interface for management
  • Limited built-in SSL/TLS certificate management
  • Requires more manual configuration for advanced features

Code Comparison

nginx-proxy:

FROM nginx:alpine
COPY nginx.tmpl /etc/docker-gen/templates/
COPY docker-entrypoint.sh /app/docker-entrypoint.sh
ENTRYPOINT ["/app/docker-entrypoint.sh"]
CMD ["forego", "start", "-r"]

nginx-proxy-manager:

FROM jc21/nginx-proxy-manager:latest
COPY custom_nginx.conf /app/nginx/custom_nginx.conf
EXPOSE 80 81 443
VOLUME ["/data", "/etc/letsencrypt"]

nginx-proxy focuses on a lightweight, template-based approach for dynamic Nginx configuration, while nginx-proxy-manager provides a more comprehensive solution with a user interface and built-in SSL management. The nginx-proxy Dockerfile emphasizes the use of templates and a custom entrypoint script, whereas nginx-proxy-manager builds upon an existing image and includes additional configuration options.

Both projects serve similar purposes but cater to different user needs and preferences. nginx-proxy is better suited for users who prefer a more hands-on approach and require fine-grained control, while nginx-proxy-manager offers a more user-friendly experience with its web-based interface and simplified management features.

50,061

The Cloud Native Application Proxy

Pros of Traefik

  • Native Docker integration with automatic service discovery
  • Supports multiple providers (Docker, Kubernetes, File, etc.) out of the box
  • Built-in Let's Encrypt support for automatic SSL certificate management

Cons of Traefik

  • Steeper learning curve, especially for beginners
  • Configuration can be more complex, particularly for advanced use cases
  • Less user-friendly interface compared to Nginx Proxy Manager's GUI

Code Comparison

Traefik (YAML configuration):

http:
  routers:
    my-router:
      rule: "Host(`example.com`)"
      service: my-service
  services:
    my-service:
      loadBalancer:
        servers:
          - url: "http://localhost:8080"

Nginx Proxy Manager (JSON configuration):

{
  "proxy_hosts": [
    {
      "domain_names": ["example.com"],
      "forward_host": "localhost",
      "forward_port": 8080
    }
  ]
}

Both Traefik and Nginx Proxy Manager offer powerful reverse proxy capabilities, but they cater to different user needs. Traefik excels in container-based environments with its native Docker integration and multi-provider support, while Nginx Proxy Manager provides a more user-friendly approach with its intuitive GUI. The choice between the two depends on the specific requirements of your project and your familiarity with reverse proxy concepts.

56,905

Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS

Pros of Caddy

  • Automatic HTTPS with Let's Encrypt integration out of the box
  • Simpler configuration syntax, often requiring less code
  • Built-in HTTP/3 support for improved performance

Cons of Caddy

  • Less mature ecosystem compared to Nginx
  • May have a steeper learning curve for those familiar with Nginx
  • Limited GUI options for management (primarily CLI-based)

Code Comparison

Caddy configuration example:

example.com {
    reverse_proxy localhost:8080
}

Nginx Proxy Manager configuration (via UI):

  1. Add a new proxy host
  2. Enter domain: example.com
  3. Enter forward hostname/IP: localhost
  4. Enter forward port: 8080
  5. Save

While Nginx Proxy Manager provides a user-friendly interface for configuration, Caddy's syntax is more concise and readable in code form. However, Nginx Proxy Manager's GUI can be easier for beginners or those who prefer visual configuration.

Both projects aim to simplify reverse proxy and web server management, but they take different approaches. Caddy focuses on simplicity and modern features in its configuration, while Nginx Proxy Manager provides a user-friendly interface on top of the powerful Nginx server.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README



This project comes as a pre-built docker image that enables you to easily forward to your websites running at home or otherwise, including free SSL, without having to know too much about Nginx or Letsencrypt.

Project Goal

I created this project to fill a personal need to provide users with an easy way to accomplish reverse proxying hosts with SSL termination and it had to be so easy that a monkey could do it. This goal hasn't changed. While there might be advanced options they are optional and the project should be as simple as possible so that the barrier for entry here is low.

Buy Me A Coffee

Features

  • Beautiful and Secure Admin Interface based on Tabler
  • Easily create forwarding domains, redirections, streams and 404 hosts without knowing anything about Nginx
  • Free SSL using Let's Encrypt or provide your own custom SSL certificates
  • Access Lists and basic HTTP Authentication for your hosts
  • Advanced Nginx configuration available for super users
  • User management, permissions and audit log

Hosting your home network

I won't go in to too much detail here but here are the basics for someone new to this self-hosted world.

  1. Your home router will have a Port Forwarding section somewhere. Log in and find it
  2. Add port forwarding for port 80 and 443 to the server hosting this project
  3. Configure your domain name details to point to your home, either with a static ip or a service like DuckDNS or Amazon Route53
  4. Use the Nginx Proxy Manager as your gateway to forward to your other web based services

Quick Setup

  1. Install Docker and Docker-Compose
  1. Create a docker-compose.yml file similar to this:
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

This is the bare minimum configuration required. See the documentation for more.

  1. Bring up your stack by running
docker-compose up -d

# If using docker-compose-plugin
docker compose up -d

  1. Log in to the Admin UI

When your docker container is running, connect to it on port 81 for the admin interface. Sometimes this can take a little bit because of the entropy of keys.

http://127.0.0.1:81

Default Admin User:

Email:    admin@example.com
Password: changeme

Immediately after logging in with this default user you will be asked to modify your details and change your password.

Contributing

All are welcome to create pull requests for this project, against the develop branch. Official releases are created from the master branch.

CI is used in this project. All PR's must pass before being considered. After passing, docker builds for PR's are available on dockerhub for manual verifications.

Documentation within the develop branch is available for preview at https://develop.nginxproxymanager.com

Contributors

Special thanks to all of our contributors.

Getting Support

  1. Found a bug?
  2. Discussions
  3. Reddit