Gray Duck Mail

Gray Duck Mail is provided as a docker image.

docker pull wagesj45/gray-duck-mail

Configuration

Gray Duck Mail requires a minimum amount of set up and has sane defaults set up to get your discussion list up and running quickly.

Ports

The docker image requires an HTTP port exposed and mapped to port 80 on the container. An optional HTTP port mapped to port 5000 on the container can accept externally accessible unsubscribe requests.

Volumes

A single volume mounted to /database is required. This volume will store the local SQLite3 database file is stored. This volume provides non-volitile storage so that data is not lost between docker image upgrades.

Environment Variables

• RATE_LIMIT_PER_ROUND_COUNT

  The number of emails that can be sent before a defined time-out period. This is useful for email providers that place restrictions on the number of emails that can be sent. The default value is a System.Int32 set to 20.

• RATE_LIMIT_ROUND_WAIT_TIME

  The time between sending groups of emails from the queue. After a given round of emails sent, the system will wait this amount of time before continuing from the email the queue. The default value is a System.TimeSpan set to 00:05:00.

• FETCH_TIME

  The time between fetching email from the remote server. The default value is a System.TimeSpan set to 00:05:00.

• LOG_LEVEL

  The verbosity level with which to log application events. The default value is a System.String set to info.

  The following values are supported:

  trace, all
  debug, verbose
  info, information
  warn, warning
  err, error
  fatal

• MIN_SEARCH_SCORE

  The minimum viable search score when performing fuzzy searches. The default value is a System.Single (float) set to 0.2. When using fuzzy searches, fractional scores between 1 and 0 are generated. Results approach zero as search results stray from an exact match.

• WEB_ONLY

  If set, only the web interface will be initialized. Background worker threads will not be initialized. This is useful for running the web administration interface without the risk of background service workers modifying the remote mail server. The default value is a System.Boolean set to 0.

  The following values are supported:

  True, 1
  False, 0
  

• WEB_UNSUBSCRIBE

  If set, an unsubscribe link will be generated and used in system and relayed messages. If unset, a link to the unsubscribe alias will be generated. The default value is a System.Boolean set to 1.

  The following values are supported:

  True, 1
  False, 0
  

• WEB_USE_HTTPS

  If set, the URL generated for a externally accessible unsubscribe link will be generated using HTTPS. Otherwise, it will generated using HTTP. The default value is a System.Boolean set to 1.

  The following values are supported:

  True, 1
  False, 0
  

• WEB_EXTERNAL_URL

  The host name used when generating an externally accessible unsubscribe link. The default value is a System.String set to example.com.

• ASPNETCORE_URLS

  The URLs monitored by the ASP.Net server runtime. The default value is a System.String set to http://+:5000;http://+:80. You can learn more , but unless you're an advanced user modifying the Gray Duck Mail Docker image, you should leave this value at its default and ensure poth ports 80 and 5000 are configured. When configuring your Docker container, only port 80 is required for normal functioning.