docs: add NPM Auth Gateway to third-party integrations#5403
Open
Mark0025 wants to merge 1 commit intoNginxProxyManager:developfrom
Open
docs: add NPM Auth Gateway to third-party integrations#5403Mark0025 wants to merge 1 commit intoNginxProxyManager:developfrom
Mark0025 wants to merge 1 commit intoNginxProxyManager:developfrom
Conversation
Add NPM Auth Gateway — a companion app that adds user-level access control with auto IP whitelisting on top of NPM's access list system. NPM remains authoritative. The gateway only reads/writes through NPM's REST API. If the gateway goes down, all existing IP whitelists persist in NPM. Running in production managing 90+ proxy hosts.
|
Docker Image for build 1 is available on DockerHub: Note Ensure you backup your NPM instance before testing this image! Especially if there are database changes. Warning Changes and additions to DNS Providers require verification by at least 2 members of the community! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What This PR Does
Adds NPM Auth Gateway to the third-party integrations page, with a dedicated documentation page explaining what it does and how it works.
Why
First — I want to say that Nginx Proxy Manager has been incredible for me. I'm self-hosting 91 Docker containers on a Hetzner homelab, and NPM is the backbone that makes all of it accessible. SSL, reverse proxy, access lists — it just works. I genuinely wouldn't have this setup without your project.
The one thing I kept hitting was user management for access lists. I build tools and want to share them with specific people — a contractor, a business partner, a friend. The workflow was always:
So I built a companion app that solves this. It sits alongside NPM on the same Docker network and uses NPM's REST API to auto-manage IPs. Users log in through an auth provider, the app detects their IP, and adds it to the NPM access lists they've been assigned to.
NPM stays the boss. The app never stores proxy config or access list data — it reads and writes through NPM's API exclusively. If the companion app goes down, NPM keeps enforcing every existing IP whitelist. Zero state duplication.
What's In This PR
docs/src/third-party/index.md(the integration list)docs/src/third-party/npm-auth-gateway.md(dedicated page with architecture, features, API endpoints used)Who Would Use This
Anyone running NPM who wants to share self-hosted services with other people without manually managing IPs:
The app handles the tedious part (IP detection, ACL updates, login logging) while NPM handles the security part (actually enforcing the whitelists at the nginx level).
Links
Thank you for building NPM — it's one of those tools that makes self-hosting actually enjoyable.
— Mark Carpenter | aireinvestor.com