# nginxproxymanager/nginx-proxy-manager architecture

> Architecture diagram of the GitHub repository nginxproxymanager/nginx-proxy-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nginxproxymanager/nginx-proxy-manager
- Repository: https://github.com/nginxproxymanager/nginx-proxy-manager

## Overview

Nginx Proxy Manager is a web-administered reverse-proxy manager. An administrator uses the interface to configure proxy, redirect, stream, or 404 hosts and certificates; the backend exposes these operations as routed APIs and manages persistent configuration. Separate capabilities cover access control, users, audit, logs, and settings. The graph shows the backend’s evidenced route and storage boundaries; frontend-to-API wiring is not shown in the sampled sources, so that connection is marked unverified. README statements establish product capabilities, not unsampled implementation details.

Main entry points: [`frontend/src/App.tsx`](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/frontend/src/App.tsx) (Admin UI), [`backend/routes/main.js`](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/main.js) (API router), [`backend/internal/certificate.js`](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/certificate.js) (Certificate lifecycle), [`backend/db.js`](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/db.js) (Database connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin interface"]
  node_frontend["Admin UI<br/>[App.tsx]"]
  node_host_pages["Host management"]
  node_cert_pages["Certificate UI"]
end

subgraph group_api["API and access"]
  node_backend_api["HTTP server<br/>[app.js]"]
  node_api_router["API router<br/>[main.js]"]
end

subgraph group_proxy["Proxy configuration"]
  node_host_routes["Host endpoints"]
  node_proxy_logic["Host operations<br/>[proxy-host.js]"]
  node_nginx_manager["Nginx manager<br/>[nginx.js]"]
  node_access_lists["Access lists<br/>[access-list.js]"]
  node_cert_routes["Certificate endpoints<br/>[certificates.js]"]
  node_cert_manager["Certificate lifecycle<br/>[certificate.js]"]
  node_certbot["Certbot integration<br/>[certbot.js]"]
end

subgraph group_identity["Identity and governance"]
  node_auth_routes["User and token routes<br/>[users.js]"]
  node_access_control["Permissions<br/>[access.js]"]
  node_audit_logs["Audit and logs<br/>[audit-log.js]"]
end

subgraph group_runtime["Runtime and persistence"]
  node_db_config["Database connection<br/>[db.js]"]
  node_host_models[("Host records<br/>[proxy_host.js]")]
  node_certificate_model[("Certificate records<br/>[certificate.js]")]
  node_user_model[("User records<br/>[user.js]")]
  node_app_settings["Initial setup<br/>[setup.js]"]
  node_config["Runtime config<br/>[config.js]"]
end

node_admin_actor(("Administrator"))

node_admin_actor -->|"configures through"| node_frontend
node_frontend -->|"offers host controls"| node_host_pages
node_frontend -->|"offers SSL controls"| node_cert_pages
node_frontend -.->|"uses API"| node_backend_api
node_backend_api -->|"mounts"| node_api_router
node_api_router -->|"routes requests"| node_host_routes
node_api_router -->|"routes requests"| node_cert_routes
node_api_router -->|"routes requests"| node_auth_routes
node_host_routes -->|"dispatches to"| node_proxy_logic
node_cert_routes -->|"dispatches to"| node_cert_manager
node_cert_manager -->|"installs plugins"| node_certbot
node_cert_manager -->|"reads and writes"| node_certificate_model
node_cert_manager -->|"coordinates certificates"| node_nginx_manager
node_proxy_logic -.->|"configures Nginx"| node_nginx_manager
node_auth_routes -->|"checks permissions"| node_access_control
node_access_control -->|"loads user"| node_user_model
node_access_control -->|"scopes host access"| node_host_models
node_host_models -->|"uses database"| node_db_config
node_certificate_model -->|"uses database"| node_db_config
node_user_model -->|"uses database"| node_db_config
node_db_config -->|"loads settings"| node_config
node_app_settings -->|"checks setup"| node_user_model
node_app_settings -->|"loads certificates"| node_certificate_model

click node_frontend "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/frontend/src/App.tsx"
click node_host_pages "https://github.com/nginxproxymanager/nginx-proxy-manager/tree/develop/frontend/src/pages/Nginx"
click node_cert_pages "https://github.com/nginxproxymanager/nginx-proxy-manager/tree/develop/frontend/src/pages/Certificates"
click node_backend_api "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/app.js"
click node_api_router "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/main.js"
click node_host_routes "https://github.com/nginxproxymanager/nginx-proxy-manager/tree/develop/backend/routes/nginx"
click node_proxy_logic "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/proxy-host.js"
click node_nginx_manager "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/nginx.js"
click node_access_lists "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/access-list.js"
click node_cert_routes "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/nginx/certificates.js"
click node_cert_manager "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/certificate.js"
click node_certbot "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/lib/certbot.js"
click node_auth_routes "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/users.js"
click node_access_control "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/lib/access.js"
click node_audit_logs "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/audit-log.js"
click node_db_config "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/db.js"
click node_host_models "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/models/proxy_host.js"
click node_certificate_model "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/models/certificate.js"
click node_user_model "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/models/user.js"
click node_app_settings "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/setup.js"
click node_config "https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/lib/config.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_host_pages,node_cert_pages toneBlue
class node_backend_api,node_api_router toneAmber
class node_host_routes,node_proxy_logic,node_nginx_manager,node_access_lists,node_cert_routes,node_cert_manager,node_certbot toneMint
class node_auth_routes,node_access_control,node_audit_logs toneRose
class node_db_config,node_host_models,node_certificate_model,node_user_model,node_app_settings,node_config,node_admin_actor toneIndigo
```

## Components

### Admin interface

- [Admin UI](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Host management](https://github.com/nginxproxymanager/nginx-proxy-manager/tree/develop/frontend/src/pages/Nginx): `frontend/src/pages/Nginx`
- [Certificate UI](https://github.com/nginxproxymanager/nginx-proxy-manager/tree/develop/frontend/src/pages/Certificates): `frontend/src/pages/Certificates`

### API and access

- [HTTP server](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/app.js): `backend/app.js`
- [API router](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/main.js): `backend/routes/main.js`

### Proxy configuration

- [Host endpoints](https://github.com/nginxproxymanager/nginx-proxy-manager/tree/develop/backend/routes/nginx): `backend/routes/nginx`
- [Host operations](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/proxy-host.js): `backend/internal/proxy-host.js`
- [Nginx manager](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/nginx.js): `backend/internal/nginx.js`
- [Access lists](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/access-list.js): `backend/internal/access-list.js`
- [Certificate endpoints](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/nginx/certificates.js): `backend/routes/nginx/certificates.js`
- [Certificate lifecycle](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/certificate.js): `backend/internal/certificate.js`
- [Certbot integration](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/lib/certbot.js): `backend/lib/certbot.js`

### Identity and governance

- [User and token routes](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/routes/users.js): `backend/routes/users.js`
- [Permissions](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/lib/access.js): `backend/lib/access.js`
- [Audit and logs](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/internal/audit-log.js): `backend/internal/audit-log.js`

### Runtime and persistence

- [Database connection](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/db.js): `backend/db.js`
- [Host records](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/models/proxy_host.js): `backend/models/proxy_host.js`
- [Certificate records](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/models/certificate.js): `backend/models/certificate.js`
- [User records](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/models/user.js): `backend/models/user.js`
- [Initial setup](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/setup.js): `backend/setup.js`
- [Runtime config](https://github.com/nginxproxymanager/nginx-proxy-manager/blob/develop/backend/lib/config.js): `backend/lib/config.js`

### Other components

- **Administrator**

## Connections

- Administrator → Admin UI: configures through (evidence: `README.md`)
- Admin UI → Host management: offers host controls (evidence: `README.md`)
- Admin UI → Certificate UI: offers SSL controls (evidence: `README.md`)
- Admin UI → HTTP server: uses API
- HTTP server → API router: mounts (evidence: `backend/app.js`)
- API router → Host endpoints: routes requests (evidence: `backend/routes/main.js`)
- API router → Certificate endpoints: routes requests (evidence: `backend/routes/main.js`)
- API router → User and token routes: routes requests (evidence: `backend/routes/main.js`)
- Host endpoints → Host operations: dispatches to (evidence: `backend/routes/nginx/proxy_hosts.js`)
- Certificate endpoints → Certificate lifecycle: dispatches to (evidence: `backend/routes/nginx/certificates.js`)
- Certificate lifecycle → Certbot integration: installs plugins (evidence: `backend/internal/certificate.js`)
- Certificate lifecycle → Certificate records: reads and writes (evidence: `backend/internal/certificate.js`)
- Certificate lifecycle → Nginx manager: coordinates certificates (evidence: `backend/internal/certificate.js`)
- Host operations → Nginx manager: configures Nginx
- User and token routes → Permissions: checks permissions (evidence: `backend/routes/users.js`)
- Permissions → User records: loads user (evidence: `backend/lib/access.js`)
- Permissions → Host records: scopes host access (evidence: `backend/lib/access.js`)
- Host records → Database connection: uses database
- Certificate records → Database connection: uses database (evidence: `backend/models/certificate.js`)
- User records → Database connection: uses database (evidence: `backend/models/user.js`)
- Database connection → Runtime config: loads settings (evidence: `backend/db.js`)
- Initial setup → User records: checks setup (evidence: `backend/setup.js`)
- Initial setup → Certificate records: loads certificates (evidence: `backend/setup.js`)
