Containerized Version of Email OAuth 2.0 Proxy This runs in --no-gui mode.

This repository has an automated method that will rebuild the docker container if an issue is opened (see the issues tab). This is to accommodate any changes to the python on Email OAuth 2.0 Proxy. If this docker image is out of date, please submit that request and it will build automatically.

The config file should be named emailproxy.config and placed in whichever folder you map via Docker Run or Docker Compose.

The email OAuth2 proxy can be run using either Docker compose or Docker run.

version: '3.7'

services:
  emailproxy:
    image: blacktirion/email-oauth2-proxy-docker # ghcr.io optional. this is published on both Docker Hub and Github Container Repository
    container_name: emailproxy
    volumes:
      /path/to/config:/config
    ports:
      1993:1993
    environment:
      LOGFILE: true
      DEBUG: true
      CACHE_STORE: /config/credstore.config
      LOCAL_SERVER_AUTH: true #Optional

This will create a new container with the email OAuth2 proxy and start it. The proxy will be listening on port 1993.

The volumes section of the Docker compose file mounts the /path/to/config volume into the container. This volume contains the configuration files for the email OAuth2 proxy.

The ports section of the Docker compose file exposes port 1993 from the container to the host machine. This is the port that the email OAuth2 proxy listens on.

The environment section of the Docker compose file sets the following environment variables in the container:

• LOGFILE: Whether or not the email OAuth2 proxy should log to a file.
• DEBUG: Whether or not the email OAuth2 proxy should run in debug mode.
• CACHE_STORE: The path to the file that the email OAuth2 proxy will use to store its cache. This should always be stored in /config/<filename> This is because it needs to write to a persistent storage to keep the tokens. If using AWS Secrets Manager, see the main proxy github for more details.
• LOCAL_SERVER_AUTH: Puts the proxy in local server auth mode. See the proxy github for details. Defaults to external auth.

To run the email OAuth2 proxy using Docker run, use the following command:

docker run -d \
    --name emailproxy \
    -e DEBUG=false \
    -e CACHE_STORE=/config/credstore.config \
    -e LOGFILE=true \
    -e LOCAL_SERVER_AUTH=true \
    -v /path/to/host/config:/config \
    -p 1993:1993 \
    blacktirion/email-oauth2-proxy-docker

This will create a new container with the email OAuth2 proxy and start it. The proxy will be listening on port 1993.

@gerneio opened an issue regarding native windows support. I do not use containers in windows, but he did put together a basic guide that can get you started. I will leave that issue open and pinned for now, just in case there are other questions. I cannot support this directly, as I am not familiar with windows docker images, but I will reply in thread if questions are asked. It seems pretty straightforward.