Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
To get up and running quickly, you can follow these steps. You'll have a basic Postal installation ready to go in in less than 10 minutes.
Provision a new server running Ubuntu 16.04 LTS. This can be from any provider. We use Digital Ocean for testing.
Login to your new server as
rootand run the following command to install Postal:
curl https://raw.githubusercontent.com/atech/postal/master/script/install/ubuntu1604.sh | sh
- Create a new user for you to login with:
Access your Postal installation in a web browser. You'll start with an SSL warning because the certificate isn't valid but you can fix that later.
You should also be able to access the SMTP server on port
Now your installation is active, there are a few things you can look at doing next.
Change your MySQL & RabbitMQ passwords. By default they are set to
p0stalpassw0rdand the MySQL root password is blank.
Replace the self signed certificates in
/etc/nginx/ssl/postal.certwith something proper. You can use something like CertBot to get you one for free through Let's Encrypt.
Set up your DNS appropriately, see the guide for full details.
Configure spam & virus checking, see the guide for full details
Configure click/open tracking, see the guide for full details.
Configure Postal to start on boot