Getting started

What’s New

Roadmap

Octeth Training Program

Installation & Setup

Requirements

Architecture

Server Setup

Oempro Installation

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Video Tutorials

Administration

Quick Walkthrough

Security

Sub Admin Accounts

Settings

Delivery Servers

Global Segments

Global Custom Fields

Bounce Processing

Spam Complaints

Suppression List

Plug-Ins

Delivery Report

User Management

Maintenance

Audience Management

Introduction

Subscriber Lists

Custom Fields

Segments

Subscribers

Webhooks

Website Event Tracking

Email Marketing

Introduction

Auto Responders

Email Campaigns

Sender Domain Man.

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

Link Proxy Add-On

Developers

Introduction

Single Sign On

API

Plug-In Development

Database

Advanced

Reverse Proxy

Cookbook

Help

Troubleshooting

Contact Us

Bounce Catcher Add-On

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

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

How To Enable TLS

Questions?

If you have any questions, please don't hesitate to reach out to us at hello@octeth.com; we would be more than happy to help.

On this page

• Bounce Catcher Add-On
• Installation
• IP Address and Domain Setup
• How To Enable TLS
• Questions?