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 Registry 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.7

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

Networking

Port	Description
5000	Procodile
25	SMTP
587	Submission

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