hub.docker.com/r/tiredofit/postal

[]

Introduction

Dockerfile to build a Postal SMTP server for sending and receiving SMTP / HTTP API email.

• This Container uses a customized Alpine base which includes s6 overlay enabled for PID 1 Init capabilities, zabbix-agent for individual container monitoring, Cron also installed along with other tools (bash,curl, less, logrotate, nano, vim) for easier management.

Changelog

Authors

• Dave Conroy

Table of Contents

• Introduction
  • Changelog
• Prerequisites
• Installation
• Quick Start
• Configuration
  • Data Volumes
  • Environment Variables
• Maintenance
  • Shell Access
  • References

Prerequisites

RabbitMQ Server MariaDB Server Spamassassin optional Clam Antivirus optional

Installation

Automated builds of the image are available on Docker Hub and is the recommended method of installation.

docker pull hub.docker.com/tiredofit/postal:(imagetag)

The following image tags are available:

• latest - Most recent release of postal w/Alpine Linux 3.11 + Ruby 2.6

Quick Start

• The quickest way to get started is using docker-compose. See the examples folder for a working docker-compose.yml that can be modified for development or production use.

• Set various environment variables to understand the capabilities of this image.

• Map persistent storage for access to configuration and data files for backup.

Configuration

Environment Variables

Along with the Environment Variables from the Base image, below is the complete list of available options that can be used to customize your installation.

Parameter	Description
DB_HOST	Hostname of MariaDB Container
DB_NAME	Name of MariaDB Database
DB_USER	Database Username
DB_PASS	Password for Above User
DB_PORT	MariaDB Server Port - Default 3306
DB_ROOT_PASS	Needed for first boot - Assigns privileges to $DB_USER. MySQL Root Pass
RABBITMQ_HOST	RabbitMQ Hostname or Container
RABBITMQ_VHOST	RabbitMQ VHost shard
RABBITMQ_USER	RabbitMQ Username
RABBITMQ_PASS	RabbitMQ Password
RABBITMQ_PORT	RabbitMQ Port - Default 5672
ENABLE_CLAMAV	Enable ClamAV true or false - Default false
ENABLE_SPAMASSASSIN	Enable Spamassassin true or false - Default false
CLAMAV_HOST	Hostname of Clamd Server
SPAMASSASSIN_HOST	Hostname of Spamassassin Server
CLAMAV_PORT	TCP Port of Clamd Server - Default 3310
SPAMASSASSIN_PORT	TCP Port of Spamassassin Process - Default 737
LOG_CONSOLE	Log to Stdout Console true or false - Default true
WEB_HOST	Hostname of Webhost for SMTP Invites - Default postal.example.com
`WEB_PROTOCOL	Protocol of Webhost for SMTP Invites http or https - Default http

Networking

Port	Description
25	SMTP
5000	Procodile

Maintenance

Shell Access

For debugging and maintenance purposes you may want access the containers shell.

docker exec -it (whatever your container name is e.g. postal) bash

References

• https://github.com/atech/postal