Getting started

Roadmap

Octeth Training Program

Installation & Setup

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Administration

Audience Management

Website Event Tracking

Email Marketing

Journeys (Automation)

Bounce Processing

Email Personalization

FBL Processing

Email Builder Integrations

Email Deliverability

Sender Domain Management

Plug-Ins & Add-Ons

AI Plug-In

RSS Plug-In

Bounce Catcher Add-On

Developers

API

Advanced

Help

Bounce Catcher Add-On

⚠️

This add-on requires Octeth v5.1.1 or newer version.

This add-on will take care of all incoming bounce report emails as well as list-unsubscribe emails. This add-on requires a separate VM instance to run. It shouldn’t be installed on the same server with Octeth.

This add-on contains;

Postfix for inbound email handling
Dovecot for IMAP mailbox access
Supervisor for daemon process management
PHP for the Octeth integration

ℹ️

This module is provided as an open-source module to the Octeth community. You can take a look at the Github repo and star it here.

Installation

After initiating your Linux VM (this document is written for the Ubuntu Linux distribution), follow these steps on the server with root access.

Update package sources list with the latest versions of the packages int he repositories:

apt update

Install packages:

apt install -y software-properties-common sharutils apt-utils iputils-ping telnet git unzip zip openssl vim wget debconf-utils cron supervisor mysql-client docker.io ufw make

Install Docker Compose and make it executable:

curl -L "https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-linux-x86_64" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose
docker-compose --version

Create the module directory:

mkdir /opt/oempro-mx-server
cd /opt/oempro-mx-server

Clone the repository:

git clone https://github.com/octeth/oempro-mx-server.git .

Create .env files:

cp .env_example .env
cd alias-server/
cp .env_example .env

Edit and configure .env files.

Build and run the system:

make build
make run

Edit the Postfix main.cf and change the myhostname parameter:

vi /opt/oempro-mx-server/docker-data/etc-postfix/main.cf

Update directory and file permissions:

touch /opt/oempro-mx-server/docker-data/var-mail/catchall
chmod 0777 /opt/oempro-mx-server/docker-data/catchall-imap
chmod 0777 /opt/oempro-mx-server/docker-data/var-mail
chmod 0777 /opt/oempro-mx-server/docker-data/var-mail/catchall
chmod 0777 /opt/oempro-mx-server/docker-data/redis-data

Once the Postfix configuration change is made, restart the container:

cd /opt/oempro-mx-server/
make kill
make run

IP Address and Domain Setup

Let's assume 192.168.0.100 is your server IP address and you will use mx.mydomain.com as MX domain.

Make sure you set the PTR of 192.168.0.100 to mx.mydomain.com
Make sure you set A record for mx.mydomain.com pointing to 192.168.0.100
Make sure you edit /opt/oempro-mx-server/docker-data/etc-postfix/main.cf and set the value of myhostname to mx.mydomain.com