joschi75/oauth2_proxy repository overview

For detailed instructions how to use and configure oauth2_proxy see https://github.com/simonrob/email-oauth2-proxy⁠

Current latest image version is based on

• Python 3.13 alpine image released by the Python project: https://hub.docker.com/_/python/tags?page=1&name=alpine⁠
• oauth2_script version 2026-07-03: https://github.com/simonrob/email-oauth2-proxy/releases/tag/2026-07-03⁠

Sample stack file

oauth2_proxy:
  image: docker.io/joschi75/oauth2_proxy:latest
  hostname: oauth2_proxy
  command:
    - --config-file=/emailproxy/config/emailproxy.config
  environment:
    HTTPS: 1
  ports:
    - 8088:8088
    - 1993:1993
    - 1587:1587
  volumes:
     - /path/to/your/volume/config:/emailproxy/config

HTTPS environment variable is only required in case of a redirect_uri which is HTTPS based (e.g. for O365, which does not allow HTTP for redirect_uri other than http://localhost⁠)

If you are using custom redirect_listen_address with a port other than 80 make sure to add it to the published ports (e.g. port 8088 as in the example above)