About lightsail-miab-installer

lightsail-miab-installer is a user-friendly command-line tool designed to streamline the setup of Mail-in-a-Box (a comprehensive mail server package) on Amazon Lightsail. This installer is configured to integrate with Amazon S3 for backups and Amazon SES for email sending (relay), it offers a quick and efficient way to host your own email solution.

To begin installation, run the following command.

sh lightsail-miab-installer.sh \
  --installation-id demo \
  --az ap-southeast-1a  \
  --email admin@example.com \
  --hostname box.example.com

Your mail server should up and running in few minutes, and you can access it using a web interface. By default it will be installed on $5 USD/mo Amazon Lightsail instance.

All the data in your Amazon S3 bucket will be preserved, allowing you to restore it on another machine if needed. Additionally, you have the option to delete the stack using the CloudFormation web console or AWS CLI.

Navigate:

• Requirements
• Installation
• Usage and Examples
  • Specify hostname
  • Specify email and password for Administrator
  • Specify instance type
  • Specify availability zone
  • Restore from backup
  • Destroy installation
  • Dry run mode
• Post installation
• FAQ
  • I cannot send an email, what's wrong?
  • I am not receiving any emails, what's wrong?
  • The installation is stuck, what should I do?
  • Is it safe to delete installation via CloudFormation?
  • How do I skip SSH passphrase?
• Changelog
• Todo
• Credits
• Contributing
• License

Requirements

Prerequisites for running this script:

• An active AWS account with sufficient permissions.
• AWS CLI v2.
• SSH client
• Basic shell utilities such as awk aws base64 cat cut date openssl sed ssh tee tr wc
• jq

lightsail-miab-installer has been tested using following shells:

• bash v4.2 (Linux)
• zsh v5.8.1 (macOS, Linux)

Installation