postal/README.md

48 lines
2.6 KiB
Markdown
Raw Normal View History

2018-07-24 06:51:11 +02:00
#### Alpine Linux Container (Default)
2018-08-03 06:16:16 +02:00
[![](https://images.microbadger.com/badges/image/catdeployed/postal:alpine.svg)](https://hub.docker.com/r/catdeployed/postal/) [![](https://img.shields.io/microbadger/layers/catdeployed/postal/alpine.svg)](https://hub.docker.com/r/catdeployed/postal/)
2018-07-24 06:34:44 +02:00
2018-08-03 04:39:27 +02:00
For this container, use the 'alpine' folder.
2018-07-24 06:34:44 +02:00
#### Ubuntu Linux Container
2018-08-03 06:16:16 +02:00
[![](https://images.microbadger.com/badges/image/catdeployed/postal:ubuntu.svg)](https://hub.docker.com/r/catdeployed/postal/) [![](https://img.shields.io/microbadger/layers/catdeployed/postal/ubuntu.svg)](https://hub.docker.com/r/catdeployed/postal/)
2018-07-24 06:33:32 +02:00
2018-08-03 06:16:16 +02:00
For this container, use the 'ubuntu' folder.
2017-04-27 11:23:57 +02:00
### Instructions
2018-08-03 04:39:27 +02:00
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.
2017-04-27 11:23:57 +02:00
2017-05-06 04:31:47 +02:00
Then, begin by following the directions at https://github.com/atech/postal/wiki/Installation#initialize-database--assets.
2017-05-13 18:14:25 +02:00
Postal can be accessed by checking the section below. Note that `postal intialize-config` is already run for you, as the database parameters need to be configured to match the environment variables before the postal tool can be used.
2017-05-06 04:31:47 +02:00
After configuration is done, run the following to bring the container up.
2017-04-27 11:23:57 +02:00
```
docker-compose up -d
```
2017-05-06 04:31:47 +02:00
### 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
```
2017-04-28 01:07:05 +02:00
2017-05-06 04:31:47 +02:00
### Migrations
2017-05-13 18:14:25 +02:00
See https://github.com/atech/postal/wiki/Upgrading. 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.
2017-04-27 21:38:31 +02:00
2017-05-11 19:27:27 +02:00
### Ports
Port mappings may change (as they have in the past). If SMTP/HTTP(s) is not working, verify that the mapped ports are correct.
2017-05-13 18:08:59 +02:00
### Anti-Spam / Antivirus
2017-05-13 18:14:25 +02:00
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.
2018-08-03 06:02:42 +02:00
### Updates
- v2.0.0
* Update to more reliable version of YAML management system
* Split into ubuntu and alpine images
2018-08-03 06:06:28 +02:00
* Moved to CircleCI for more advanced building
2018-08-03 06:02:42 +02:00
- v1.0.0
* Initial Release