OAuth2 Proxy

OAuth2 Proxy is a flexible, open-source reverse proxy that protects your services with OAuth2 / OpenID Connect login, validating users by email address,…

  • Network Services
  • Other
  • Security
  • Tools & Utilities
OAuth2 Proxy is a flexible, open-source reverse proxy that protects your services with OAuth2 / OpenID Connect login, validating users by email address, domain, or group. It can run standalone or as middleware inside an existing proxy or load balancer, and supports Google, GitHub, and dozens of other providers, giving homelab admins a simple, secure way to gate self-hosted apps.

Platform availability

Available on 4 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

73/100 Good

Maintained
98last commit 13 days ago
Popular
8415,375 GitHub stars
Easy to install
654 install platforms, install notes, Docker image
Light to run
701 GB minimum RAM
Security check
201 serious finding, 1 minor, CI, tests, OpenSSF Scorecard 4.8/10

Availability: platform listings confirmed today, links checked 3 days ago

GitHub stars
15,375
Open issues
292
Last commit
2026-11-08
Latest release
v7.15.6
License
MIT
Activity
rising

Checked 6 days ago - source: GitHub (pusher/oauth2_proxy)

Resources & Compatibility

Minimum requirements: 1 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add your OAuth app details before starting Fill in the provider's ClientID, ClientSecret, AuthURL, and TokenURL, and use the same redirect URI (the address the provider sends the user back to) you registered with the provider. If those don't match, login can bounce, fail, or the provider can refuse to issue a token. source
  • Use a complete Google credentials file If using Google, load a credentials JSON that has a web or installed section with client_id, client_secret, redirect_uris, auth_uri, and token_uri. Missing fields make the app fail to start or parse the file. source
  • Check the error code when login fails When the app exchanges the login code for a token, failures may include an error code. Read that code first because it explains what failed during the token exchange instead of leaving you to guess. source

Fetched 47 days ago - each note links to its source

Alternatives (5)

  • Ory - Ory builds cloud-native authentication (login), authorization (permission), delegation (OAuth2, OpenID Connect), and user management softwa…
  • Phase Two - Phase Two builds on top of Keycloak, one of the most widely used open source identity and access management systems in the world.
  • Tinyauth - Tinyauth is a lightweight OpenID Connect authentication and authorization server that adds login and access controls to self-hosted apps be…
  • authentik - Authentik is an open-source identity provider that adds flexible single sign-on, user management, and common sign-in protocol support to se…
  • pomerium - Pomerium is an identity- and context-aware reverse proxy that adds authentication and access control to internal web applications through y…

Checked 40 days ago - source: AlternativeTo

Common questions

Can I integrate OAuth2 Proxy with an existing load balancer or reverse proxy instead of running it standalone?

It can act as a middleware component integrated into existing reverse proxy or load balancer setups, as well as a standalone reverse proxy.

If settings are supplied in multiple places, which configuration source takes precedence?

Command line options overwrite environment variables, and environment variables overwrite configuration file settings.

Are the nightly container images suitable for a production deployment?

No, nightly images built from the master branch are considered unstable and should not be used for production unless you know what you're doing.

What changed with the container base image in v7.6.0, and are Alpine images still available?

From v7.6.0 and up the base image changed from Alpine to distroless. Alpine-based images are still provided with -alpine tags for debugging or cases such as armv6.

Can OAuth2 Proxy forward provider user details to upstream applications?

Specialised provider implementations can extract details such as preferred usernames and groups and forward them as HTTP headers to upstream applications.

Answers sourced from github.com, github.com, oauth2-proxy.github.io

Community

Collected 49 days ago - public community threads