nginx-proxy-manager
Docker container for managing Nginx proxy hosts with a simple, powerful interface
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
The Cloud Native Application Proxy
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:
- Ensure Docker and Docker Compose are installed on your system.
- 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
- Run the following command to start the container:
docker-compose up -d
-
Access the web interface at
http://your-server-ip:81
-
Log in with the default credentials:
- Email:
admin@example.com
- Password:
changeme
- Email:
-
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.
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.
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):
- Add a new proxy host
- Enter domain: example.com
- Enter forward hostname/IP: localhost
- Enter forward port: 8080
- 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 designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
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.
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.
- Your home router will have a Port Forwarding section somewhere. Log in and find it
- Add port forwarding for port 80 and 443 to the server hosting this project
- Configure your domain name details to point to your home, either with a static ip or a service like DuckDNS or Amazon Route53
- Use the Nginx Proxy Manager as your gateway to forward to your other web based services
Quick Setup
- Install Docker and Docker-Compose
- 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.
- Bring up your stack by running
docker-compose up -d
# If using docker-compose-plugin
docker compose up -d
- 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.
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
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
The Cloud Native Application Proxy
Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot