Skip to main content

Nginx Proxy Manager: installing the proxy panel

Nginx · 09.10.2026 · 3 min read
Illustration for “Nginx Proxy Manager: installing the proxy panel”

Nginx Proxy Manager is a web panel that sets up Nginx as a reverse proxy and issues certificates on its own. It is useful when you would rather configure things with a mouse than edit text files by hand.

What a reverse proxy is, briefly

A reverse proxy accepts a request on one domain and port, then forwards it to the right server inside the network, hiding that server's real address. If you need the actual config with directives, the details are in the article on reverse proxy in Nginx.

NPM, hand-written configs, and Traefik

All three approaches solve the same task differently, and the choice depends on how many rules there are and how often they change.

CriterionNPMHand-written configsTraefik
What is configuredthrough a web panelin text config filesthrough container labels or files
Who gets certificatesthe panel itselfa separate client that you set upTraefik itself, from labels
Where state is storedin the panel's own databasein text config filesin config and container labels
Who it suitsthose who do not want to edit config by handthose who need full controlthose with many containers and frequent changes

The separate approach based on container labels is covered in the article on Traefik.

Installing the panel as a container

The panel is set up as a container, with ports for web traffic and a separate port for signing in to the panel itself, plus volumes for data and certificates.

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

First sign-in and changing the admin details

After startup the panel opens on the sign-in port, and the first thing to do is sign in with the default administrator details and immediately change both the email and the password, which is the most common mistake when setting up the panel.

First proxy host, step by step

  1. Enter the domain the proxy host will serve.
  2. Enter the address and port of the server the panel should forward requests to.
  3. Turn on issuing an SSL certificate for that domain.
  4. Turn on redirecting from plain HTTP to the secure connection.

What breaks most often

ProblemLikely causeWhat to check
The certificate is not issuedthe confirmation port is busy or the domain does not point to the serverwhether the port is reachable from outside and the domain record
The backend is unreachablethe container address is used instead of the address the panel can seethe backend address and port in the proxy host settings
WebSocket does not workWebSocket support is not turned on for that proxy hostthe WebSocket support switch on that proxy host
The panel is exposed to the outsidethe panel's sign-in port is reachable by anyone, not just the administratorrestricting access to the panel's port

When NPM does not fit

The panel becomes awkward once there are so many rules that the interface is hard to follow, when you need non-standard directives the panel does not expose, or when the config must live in version control together with the rest of the code.

Was this article helpful?
← Back to Knowledge Base Ask Support