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

Oempro Installation

In the previous chapter, we have prepared our server for Oempro installation. Now, we will proceed with preparing the Oempro directory and executing the install utility.

1. Unzip the Oempro package:
Copy

cd /opt/oempro/
unzip oemproXXX.zip

2. Change file permissions:
Copy

chmod -R 0755 install/install.sh
chmod -R 0777 data
chmod -R 0777 system/storage/
chmod -R 0777 system/bootstrap/cache/
mkdir _dockerfiles/elasticsearch/data
chmod -R 0777 _dockerfiles/elasticsearch/data
mkdir _dockerfiles/mysql/data
chmod -R 0777 _dockerfiles/mysql/data
mkdir _dockerfiles/mysql/log
chmod -R 0777 _dockerfiles/mysql/log
mkdir _dockerfiles/rabbitmq/data
chmod -R 0777 _dockerfiles/rabbitmq/data
mkdir _dockerfiles/redis/data
chmod -R 0777 _dockerfiles/redis/data

3. Register the installation domain and download the license.dat file from Octeth Client Area
4. Execute the installer script:
Copy

cd install/
./install.sh

5. Answer the questions and the installer script will initialize the Oempro environment:
Copy

>>> Do you want to generate passwords automatically? [Y/N] => Y
>>> Are you ready?(y,n) [n]? y
>>> Enter MySQL host: [localhost] 192.168.99.108
>>> Enter MySQL port: [3306] 3306
>>> Enter MySQL database name: [oempro] oempro
>>> Enter MySQL username: [] oempro
>>> Enter MySQL password: [] *********

The information displayed above is for information only. During the install.sh installation process, the installer will display you the correct information based on your system settings.

6. Once prompted on your terminal screen, enter requested information such as application path, application URL, MySQL credentials, administrator account information to continue with the installation process:

You may refer to these default values:

Copy

>>> Application Path: /var/www/html
>>> Application URL: http://your-oempro-domain.com
>>> MySQL Host: 192.168.99.108
>>> MySQL Username: oempro
>>> MySQL Password: ****** (your MySQL password will be displayed to you during the installation process)
>>> MySQL Database: oempro
>>> Administrator Name: **** *****
>>> Administrator Email Address: ******@*****.***
>>> Administrator Username: ******
>>> Administrator Password: ******

Once you click the button, the web based installation utility will complete the process and display a success screen.

7. As the last step, configure the inbound email gateway SMTP server. Simply change your directory to:
Copy

cd /opt/oempro/_dockerfiles/inbound-smtp-server

8. Create the config.json file based on the example file:
Copy

cp config.json.example config.json

9. Copy the ADMIN API Key from /opt/oempro/data/config.inc.php file and add it to the `config.json` file:
Copy

cat /opt/oempro/data/config.inc.php | grep ADMIN_API_KEY
vi cd /opt/oempro/_dockerfiles/inbound-smtp-server/config.json

10. Paste your ADMIN API key to the config.json file:
Copy

{
  "Debug": false,
  "Listen": [
    ":25"
  ],
  "AppName": "Oempro SMTP Server",
  "Hostname": "test.local",
  "AdminAPIKey": "<<< PLACE YOUR ADMIN API KEY HERE >>>",
  "EmailMaxSizeKB": 100,
  "SMTPTimeout": 15,
  "Certificate": "",
  "PrivateKey": "",
  "MaxConnectionLimit": 1500,
  "LogFiles": {
    "Connections": "./log_connections.log",
    "Authentications": "./log_authentications.log"
  },
  "OemproAPIUrl": "http://192.168.99.101/api.php"
}%

Installation is completed.

Before using Oempro, please make sure that you either delete or rename the install directory:

rm -rf /opt/oempro/install

Now you can login to the admin area to start setting up your system:

http://your-oempro-domain.com/app/admin/

Next →

SSL Certificates

On this page

• Oempro Installation