Applies to: Nginx Proxy Manager 2.x, any Linux VPS or dedicated server with Docker
Nginx Proxy Manager is a Docker image, not a native package for your distribution. It gives you a web admin panel to forward domains to other services, with free Let's Encrypt SSL, without hand-editing Nginx config files for every site.
1. Install Docker and Docker Compose
If Docker is not already installed, use your distribution's own install script or package manager first. Confirm both are present:
docker --version && docker compose version
2. Create a folder and a docker-compose.yml
mkdir -p /opt/npm && cd /opt/npm
Create docker-compose.yml in that folder with this content, based on the project's own current example. Pin the image to a specific version rather than latest, so an update never happens without you choosing it:
services:
app:
image: 'jc21/nginx-proxy-manager:2.16.0'
restart: unless-stopped
ports:
- '80:80'
- '81:81'
- '443:443'
environment:
TZ: 'UTC'
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
3. Start it
docker compose up -d
Give it a minute on first start while it finishes its own setup.
4. Open the admin panel
Go to http://your-server-ip:81 in a browser. The project ships with a published default admin login on first launch, shown on its own setup page; change the email and password the moment you log in for the first time, before adding any proxy host.
5. Add a proxy host
In the admin panel, add a Proxy Host: the domain name you want to serve, the internal IP and port of the actual service (another Docker container, or a service running on the same VPS), and request a free SSL certificate at the same time if the domain already points at this server.
Firewall ports
Nginx Proxy Manager needs three ports reachable from outside: 80 and 443 for normal web traffic, and 81 for the admin panel. Consider restricting port 81 to your own IP once set up, since it is the login screen for the whole proxy.
Why use it instead of plain Nginx
Plain Nginx reverse proxy configuration (covered in our other Nginx articles) is more flexible, but means editing server blocks by hand and running Certbot yourself for each certificate. Nginx Proxy Manager is the better fit when you are forwarding several domains to different services on the same VPS or home network and want one panel to manage all of them, certificates included.
Official documentation: Nginx Proxy Manager setup guide.