Clone this repository and build the image with docker build <arguments> (imagename) .
Prebuilt Images
Builds of the image are available on Docker Hub and is the recommended method of installation.
The following image tags are available along with their tagged release based on what's written in the Changelog:
Container OS
Tag
Alpine
:latest
Multi Architecture
Images are built primarily for amd64 architecture, and may also include builds for arm/v6, arm/v7, arm64 and others. These variants are all unsupported. Consider sponsoring my work so that I can work with various hardware. To see if this image supports multiple architecures, type docker manifest (image):(tag)
Configuration
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.
Map persistent storage for access to configuration and data files for backup.
Persistent Storage
The following directories are used for configuration and can be mapped for persistent storage.
Directory
Description
/config/
Auto generated Postal Config and Signing Key resides here
/logs/
Logfiles
/assets/custom
Optional Use this to drop files overop of the Postal sourcode for cherry picked overrides of files
Environment Variables
Base Images used
This image relies on an Alpine Linux base image that relies on an init system for added capabilities. Outgoing SMTP capabilities are handlded via msmtp. Individual container performance monitoring is performed by zabbix-agent. Additional tools include: bash,curl,less,logrotate, nano,vim.
Be sure to view the following repositories to understand all the customizable options:
SMTP Server to be used to send messages from Postal Management System to users
127.0.0.1
SMTP_PORT
SMTP Port to be used to send messages from Postal Management System to Users
25
SMTP_USER
Username to authenticate to SMTP Server
SMTP_PASS
Password to authenticate to SMTP Server
Relay
Parameter
Description
Default
SMTP_RELAY_HOST
Relay all outbound messages to this hostname
SMTP_RELAY_PORT
SMTP Relay Port
25
SMTP_RELAY_SSL_MODE
Relay SSL / TLS Mode
Auto
Other Settings
Parameter
Description
Default
CONFIG_FILE
Configuration File
postal.yml
CONFIG_PATH
Configuration Path
/config/
FAST_SERVER_BIND_IP
Bind IP for the Web Interface
0.0.0.0
FAST_SERVER_BIND_PORT_TLS
Bind Port for the TLS Tracking Service
8443
FAST_SERVER_BIND_PORT
Bind Port for the Tracking Server
8080
SETUP_TYPE
Choose AUTO or MANUAL Setup type - Auto uses these environment variables
AUTO
SIGNING_KEY_FILE
Signing Key File
signing.key
SIGNING_KEY_SIZE
Signing Key Size
1024
WEB_BIND_IP
Bind IP for the Web Interface
0.0.0.0
WEB_BIND_PORT
Bind Port for the Web Interface
5000
WEB_HOSTNAME
Hostname for Web Interface
postal.example.com
WEB_MAX_THREADS
Max Threads for Web Interface
5
WEB_PROTOCOL
Protocol for Web Interface http or https
http
Networking
Port
Description
25
SMTP
80
Web Interface
8080
Fast Server /Tracking
8443
Fast Server / Tracking
5000
Puma`
Maintenance
Shell Access
For debugging and maintenance purposes you may want access the containers shell.
bash docker exec -it (whatever your container name is) bash
Support
These images were built to serve a specific need in a production environment and gradually have had more functionality added based on requests from the community.
Usage
The Discussions board is a great place for working with the community on tips and tricks of using this image.
An user is not being created (nothing in the users table in the database) even though I can see the following in the console:
postal-app | [WARN] ** [container] RabbitMQ Host 'postal-rabbitmq' is not accessible, retrying.. (20 seconds so far)
postal-app | [NOTICE] ** [container] Configuring Postal
postal-app | [WARN] ** [container] Detecting new Install. Initializing Database
postal-clamav | Sun Oct 25 13:12:06 2020 -> Database test passed.
postal-clamav | Sun Oct 25 13:12:06 2020 -> daily.cvd updated (version: 25967, sigs: 4335099, f-level: 63, builder: raynman)
postal-clamav | Sun Oct 25 13:12:06 2020 -> main database available for download (remote version: 59)
postal-clamav | Sun Oct 25 13:12:13 2020 -> Testing database: '/data/definitions//tmp.2e52b2ad9a/clamav-03931e9d0f42251e955663d0921e269e.tmp-main.cvd' ...
postal-app | [NOTICE] ** [container] Creating Administrative User
postal-app | [WARN] ** [container] No Admin Email entered, setting default email login to '[email protected]'
postal-app | [WARN] ** [container] WARNING: No Admin Pass entered, setting default password to 'postal'
postal-app | [WARN] ** [container] No Admin First Name entered, setting default to 'Postal'
postal-app | [WARN] ** [container] No Admin Last Name entered, setting default to 'Admin'
postal-clamav | Sun Oct 25 13:12:27 2020 -> Database test passed.
postal-clamav | Sun Oct 25 13:12:27 2020 -> main.cvd updated (version: 59, sigs: 4564902, f-level: 60, builder: sigmgr)
postal-clamav | Sun Oct 25 13:12:27 2020 -> bytecode database available for download (remote version: 331)
postal-clamav | Sun Oct 25 13:12:27 2020 -> Testing database: '/data/definitions//tmp.2e52b2ad9a/clamav-6fe8d96b89f9b01c332090ecd21ada9f.tmp-bytecode.cvd' ...
postal-clamav | Sun Oct 25 13:12:27 2020 -> Database test passed.
postal-clamav | Sun Oct 25 13:12:27 2020 -> bytecode.cvd updated (version: 331, sigs: 94, f-level: 63, builder: anvilleg)
postal-clamav | [INFO] ** [clamav] Container Initialization Complete
postal-clamav | [cont-init.d] 10-clamd: exited 0.
postal-clamav | [cont-init.d] 99-container: executing...
postal-clamav | [cont-init.d] 99-container: exited 0.
postal-clamav | [cont-init.d] done.
postal-clamav | [services.d] starting services
postal-clamav | [services.d] done.
postal-clamav | [INFO] ** [zabbix] Starting Zabbix Agent
postal-clamav | [INFO] ** [clamav] Starting ClamAV
postal-clamav | [NOTICE] ** [freshclam] Definitions Updating Routines Initialized on Sun Oct 25 13:12:38 GMT 2020
postal-clamav | [INFO] ** [freshclam] Downloading Latest Definitions
postal-app | [cont-init.d] 10-postal: exited 0.
postal-app | [cont-init.d] 99-container: executing...
postal-app | [cont-init.d] 99-container: exited 0.
postal-app | [cont-init.d] done.
postal-app | [services.d] starting services
postal-app | [services.d] done.
postal-app | [INFO] ** [zabbix] Starting Zabbix Agent
postal-app | [INFO] ** [container] Starting postal
postal-app | Started Procodile supervisor with PID 1101
postal-app | Procodile Version 1.0.26
postal-app | Application Root /app
postal-app | Supervisor PID 1101
postal-app | Started 2020-10-25 13:13:10 +0000
However, using docker exec -it bash and afterwards running /app/bin/postal make-user actually works fine.
If it makes a difference: it does create an user on my local Fedora 33 machine, but does not on a machine running Fedora CoreOS Stable which is remotely accessed with docker context.
iam trying since hours to run these containers with your docker-compose.
This shows me the app container:
`bash-5.1# procodile
Welcome to Procodile v1.0.26
For documentation see https://adam.ac/procodile.
The following commands are supported:
check_concurrency Check process concurrency
console Open a console within the environment
exec Execute a command within the environment
help Shows this help output
kill Forcefully kill all known processes
log Open/stream a Procodile log file
reload Reload Procodile configuration
restart Restart processes
start Starts processes and/or the supervisor
status Show the current status of processes
stop Stops processes and/or the supervisor
For details for the options available for each command, use the --help option.
For example 'procodile start --help'.
bash-5.1# procodile status
Procodile Version 1.0.26
Application Root /app
Supervisor PID 1221
Started 2021-05-22 11:02:35 +0000
Using docker-postal in a VPS I have encountered a "no space left on device". After having investigated, I figured out that the issue comes from the spamassasin container.
I turns out that there is an infinitely number of empty folders created within postal-spamassasin-app container, inside the /tmp folder, here's an example (I verifierd that the sise in /var/lib/docker/overlay2 growth as well because of those folders) :
bash-5.0# ls -A /tmp | head | xargs du -sh
8.0K .spamassassin10001DGbDLFtmp
8.0K .spamassassin10001UD2WI8tmp
8.0K .spamassassin1000243lK31tmp
8.0K .spamassassin100026eeizUtmp
8.0K .spamassassin10002JhfDx4tmp
8.0K .spamassassin10002s1rxFetmp
8.0K .spamassassin10002xi6f1Ntmp
8.0K .spamassassin10004VepMcItmp
8.0K .spamassassin10005NLVJRhtmp
8.0K .spamassassin10005TAVulwtmp
After running the container for ~1days, I got more than 70k folder here
bash-5.0# ls -A /tmp | wc -l
71776
Finally here is a sample of this container logs which may help understanding why all those folder are created
$ docker logs postal-spamassassin-app 2>&1| tail -n20
config: no rules were found! Do you need to run 'sa-update'?
[INFO] ** [spamassassin] Starting spamassassin
Jan 30 15:20:25.815 [9416] error: config: no rules were found! Do you need to run 'sa-update'?
config: no rules were found! Do you need to run 'sa-update'?
[INFO] ** [spamassassin] Starting spamassassin
Jan 30 15:20:26.876 [9440] error: config: no rules were found! Do you need to run 'sa-update'?
config: no rules were found! Do you need to run 'sa-update'?
[INFO] ** [spamassassin] Starting spamassassin
Jan 30 15:20:27.918 [9464] error: config: no rules were found! Do you need to run 'sa-update'?
config: no rules were found! Do you need to run 'sa-update'?
[INFO] ** [spamassassin] Starting spamassassin
[and so on...]
App container starts, but throws strange errors from bundler. (see logs below)
Tried to exec some commands by hand, but actually got the same result. Looks like the bundler does not take $PATH into account for some reason.
e.g.
bash-5.1# su - postal -s /bin/bash
4b68bee1f9bc:~$ cd /app/
4b68bee1f9bc:/app$ env|grep $PATH
PATH=/bin:/usr/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/sbin
4b68bee1f9bc:/app$ which rake
/usr/bin/rake
4b68bee1f9bc:/app$ rake --version
rake, version 12.3.3
4b68bee1f9bc:/app$ bundle exec rake postal:cron
`/app/` is not writable.
Bundler will use `/tmp/bundler/home/postal' as your home directory temporarily.
bundler: command not found: rake
Install missing gem executables with `bundle install`
Steps to reproduce
Edit docker-compose from examples like this (I don't have such external networks defined)
networks:
proxy:
services:
docker-compose up
What is the expected correct behavior?
Services started
Relevant logs and/or screenshots
postal-app | 2021-10-22-19:00:54 [STARTING] ** [postal-requeuer] [136] Starting postal master Requeuer
postal-app | `/app/` is not writable.
postal-app | Bundler will use `/tmp/bundler/home/postal' as your home directory temporarily.
postal-app | bundler: command not found: puma
postal-app | Install missing gem executables with `bundle install`
postal-app | 2021-10-22-19:00:55 [STARTING] ** [postal-smtp] [137] Starting postal master SMTP Server
postal-app | `/app/` is not writable.
postal-app | Bundler will use `/tmp/bundler/home/postal' as your home directory temporarily.
postal-app | bundler: command not found: rake
postal-app | Install missing gem executables with `bundle install`
postal-app | `/app/` is not writable.
postal-app | Bundler will use `/tmp/bundler/home/postal' as your home directory temporarily.
postal-app | bundler: command not found: rake
postal-app | Install missing gem executables with `bundle install`
postal-app | `/app/` is not writable.
postal-app | Bundler will use `/tmp/bundler/home/postal' as your home directory temporarily.
postal-app | bundler: command not found: ruby
postal-app | Install missing gem executables with `bundle install`
postal-app | `/app/` is not writable.
postal-app | Bundler will use `/tmp/bundler/home/postal' as your home directory temporarily.
postal-app | bundler: command not found: rake
We are starting to use Postal as a email relay, which in turn needs to relay to another mailserver of our company.
But one thing that I'm missing is a environment variable to set the smtp_relay option in postal.yml config file.
Or any other way of setting this during container creation.
I could probably edit the container and set a smtp_relay and save that container for internal use, but I'd rather use a public container in case of updates and such.
Hi, first thank you for taking the time to create these docker images! We're having an issue trying to run the docker image. We are getting an error requiring 'javscript run time'.. I attached a copy of the error.
Steps to reproduce
Trying to run the docker using docker compose
What is the expected correct behavior?
javascript run time should be included in the image
Hello Dave,
first of all, a BIG thak you for this docker set!
Postal is a great software which I enjoy since a long time, but having it in docker is really awesome.
Everything has pro and cons, now my install is much simpler and I can use one server to run other docker services but I miss the domain tracker feature.
Do you have any idea if the fast server could be used in this context to have domain tracking feature?