# 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, domain, or group. It is open source and self-hosted, installable on Kubernetes (Helm), Unraid and Proxmox.

Canonical page: https://ourlocalhost.com/app/3134/oauth2-proxy

## Description

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, Proxmox, Helm, Any server.

## Health score

73/100 (Good), based on 5 of 5 factors.
- Maintained: 98 (last commit 13 days ago)
- Popular: 84 (15,375 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)
- Security check: 20 (1 serious finding, 1 minor, CI, tests, OpenSSF Scorecard 4.8/10)

## Security check

1 serious finding: A GitHub workflow can be triggered by outsiders to run their code with the project's secrets.
Automated checks on commit bea3f04, 14 Oct 2026. Not an audit.

## Links

- Kubernetes (Helm): https://artifacthub.io/packages/helm/oauth2-proxy/oauth2-proxy
- GitHub: https://github.com/pusher/oauth2_proxy
- Unraid: https://ca.unraid.net/apps/oauth2-proxy-0flzjzd09x60al?q=OAuth2-Proxy
- Official website: https://oauth2-proxy.github.io/oauth2-proxy
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=oauth2-proxy
- Documentation: https://oauth2-proxy.github.io/oauth2-proxy/

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/3134/oauth2-proxy), the self-hosted and open-source app directory.
