Skip to content
Docker container for Postal (atech/postal)
Dockerfile Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci update mariadb name Jul 15, 2019
alpine Update Jul 2, 2019
ubuntu update mariadb name Jul 15, 2019
.DS_Store fix removed package Oct 17, 2018
.gitignore Update Apr 5, 2019

Alpine Linux Container (Default)

For this container, use the 'alpine' folder.

Ubuntu Linux Container

For this container, use the 'ubuntu' folder.


Change configuration in docker-compose.yml to update passwords for MySQL/RabbitMQ. Note that both passwords in the postal service, mysql service and rabbitmq service have to be changed to the same values.

Initialize Database and write assets

docker-compose run postal initialize

Create User

docker-compose run postal make-user

Running Container

After configuration is done, run the following to bring the container up.

docker-compose up -d

Using the postal tool.

To use the postal tool, simply run

docker-compose run postal <parameter>

For example, the following command runs postal initialize inside the container.

docker-compose run postal initialize


See Note that building a new container (or pulling a new version from Docker Hub) will update the files in postal, so all you have to run is postal upgrade after building or retrieving the new container. Updating postal using its auto-update feature is highly not reccomended and likely does not work properly.


Port mappings may change (as they have in the past). If SMTP/HTTP(s) is not working, verify that the mapped ports are correct.

Anti-Spam / Antivirus

The initial design for the container was to be simple, minimal, and customizable, so Spamassassin and ClamAV are not included by default. Feel free to fork and add to the Dockerfile (though you must set docker-compose.yml to build from Dockerfile and not pull an image), or add them by linking additional containers.


  • v2.0.0
    • Update to more reliable version of YAML management system
    • Split into ubuntu and alpine images
    • Moved to CircleCI for more advanced building
  • v1.0.0
    • Initial Release
You can’t perform that action at this time.