How nginxproxymanager/nginx-proxy-manager works
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: App.tsx Admin UI · main.js API router · certificate.js Certificate lifecycle · db.js Database connection
Components 22
Admin interface
- Admin UI
frontend/src/App.tsx - Host management
frontend/src/pages/Nginx - Certificate UI
frontend/src/pages/Certificates
API and access
- HTTP server
backend/app.js - API router
backend/routes/main.js
Proxy configuration
- Host endpoints
backend/routes/nginx - Host operations
backend/internal/proxy-host.js - Nginx manager
backend/internal/nginx.js - Access lists
backend/internal/access-list.js - Certificate endpoints
backend/routes/nginx/certificates.js - Certificate lifecycle
backend/internal/certificate.js - Certbot integration
backend/lib/certbot.js
Identity and governance
- User and token routes
backend/routes/users.js - Permissions
backend/lib/access.js - Audit and logs
backend/internal/audit-log.js
Runtime and persistence
- Database connection
backend/db.js - Host records
backend/models/proxy_host.js - Certificate records
backend/models/certificate.js - User records
backend/models/user.js - Initial setup
backend/setup.js - Runtime config
backend/lib/config.js
Other components
- Administrator
Connections 23
- Administrator → Admin UI: configures through
README.md - Admin UI → Host management: offers host controls
README.md - Admin UI → Certificate UI: offers SSL controls
README.md - Admin UI → HTTP server: uses API
- HTTP server → API router: mounts
backend/app.js - API router → Host endpoints: routes requests
backend/routes/main.js - API router → Certificate endpoints: routes requests
backend/routes/main.js - API router → User and token routes: routes requests
backend/routes/main.js - Host endpoints → Host operations: dispatches to
backend/routes/nginx/proxy_hosts.js - Certificate endpoints → Certificate lifecycle: dispatches to
backend/routes/nginx/certificates.js - Certificate lifecycle → Certbot integration: installs plugins
backend/internal/certificate.js - Certificate lifecycle → Certificate records: reads and writes
backend/internal/certificate.js - Certificate lifecycle → Nginx manager: coordinates certificates
backend/internal/certificate.js - Host operations → Nginx manager: configures Nginx
- User and token routes → Permissions: checks permissions
backend/routes/users.js - Permissions → User records: loads user
backend/lib/access.js - Permissions → Host records: scopes host access
backend/lib/access.js - Host records → Database connection: uses database
- Certificate records → Database connection: uses database
backend/models/certificate.js - User records → Database connection: uses database
backend/models/user.js - Database connection → Runtime config: loads settings
backend/db.js - Initial setup → User records: checks setup
backend/setup.js - Initial setup → Certificate records: loads certificates
backend/setup.js