Docker Deployment¶

Mount a certs/ directory containing cert.pem and key.pem (see Manual install to generate test certs), then run the relay on port 8025.

docker run--env-filedocker compose

docker run --name smtp-relay -p 8025:8025 \
  -v $(pwd)/certs:/usr/src/smtp-relay/certs \
  -e TLS_SOURCE=file \
  -e REQUIRE_TLS=true \
  ghcr.io/justiniven/smtp-oauth-relay:1

.env:

TLS_SOURCE=file
REQUIRE_TLS=true
SERVER_GREETING=My SMTP Relay

docker run --name smtp-relay -p 8025:8025 \
  -v $(pwd)/certs:/usr/src/smtp-relay/certs \
  --env-file .env \
  ghcr.io/justiniven/smtp-oauth-relay:1

docker-compose.yml:

services:
  smtp-relay:
    image: ghcr.io/justiniven/smtp-oauth-relay:1
    container_name: smtp-oauth-relay
    ports:
      - "8025:8025"
    volumes:
      - ./certs:/usr/src/smtp-relay/certs
    environment:
      - TLS_SOURCE=file
      - REQUIRE_TLS=true
    restart: unless-stopped

docker compose up -d
docker compose logs -f smtp-relay

See the configuration reference for all environment variables.

Build from source

git clone https://github.com/justiniven/smtp-oauth-relay.git
cd smtp-oauth-relay
docker build -t smtp-oauth-relay:local .
docker run --name smtp-relay -p 8025:8025 \
  -v $(pwd)/certs:/usr/src/smtp-relay/certs \
  -e TLS_SOURCE=file smtp-oauth-relay:local

Docker Deployment¶

Next steps¶