Knowledgebase

Installation Guide

The following guide will help you install Mumara Campaigns self-hosted version. 
 

Method 1: Auto-Installation via Command Line

Make sure that you have the minimal edition of the operating system. Login to your OS as root user and run the command below. It will install all dependencies including Apache, MySQL, PHP to install Mumara automatically.
 
cd /home && curl -o installer -L https://dl.mumara.com/installer && sh installer
We suggest running this command in the Linux screen to avoid losing operation upon connection break. If your server doesn't have screen installed, then you can install it using the command yum install screen.
 
Compatible OS Types: CentOS 7 (minimal)
SELINUX Check: It will check to disable SELINUX if found enabled and reboot the server. After reboot, you'll need to run the command again.

During the process, it will ask you certain questions to understand the basic things and install the correct license to the correct domain. Make sure that your license status is re-issued before starting the installation.
 

Method 2: Downloading & Installing Mumara Campaigns

  • Finalizing the purchase order will lead you to your billing account. If you are unsure about your billing panel then navigate to https://billing.mumara.com/clientarea.php and login using your credentials.
  • Navigate to Services -> My Services.
  • Click on the product name and find the “Download Now” button.
  • Unzip the downloaded files and upload to your website root folder. Mumara Campaigns isn’t suggested to be installed in a sub-directory e.g yourdomain.com/mumara etc due to dependencies issue. So host it on your main domain or you can even use a sub-domain to be installed on. Once the files have been uploaded, make sure that it has .htaccess file inside as most of the FTP applications consider .htaccess as a hidden file(s) and skip such files during transfer.
  • Mumara Campaigns comes up with a built-in installer that checks dependencies and files/folders permissions before proceeding with the installation. So you need to make sure that you have a MySQL database already created and a user has already been assigned to it.
  • Now open your domain name on which you have uploaded Mumara files. It will auto detect if Mumara hasn’t previously installed and will redirect you to the installer. If it doesn’t happen, you can always access installer directly by putting /install at the end of URL e.g mumara.yourdomain.com/install.


Ioncube Installation

One of the requirements to get the Mumara Campaigns installed on your server is ionCube loader. Your Apache must be compiled with the correct version of ioncube loader to match with your server’s PHP version. You can download the ionCube loader from their official website here.

http://www.ioncube.com/

Short help guide like the following provides a good amount of information on ionCube installation.

https://www.howtoforge.com/tutorial/how-to-install-ioncube-loader/

Dependencies and Requirements

If you have any control panel installed on your server (e.g cPanel, Plesk etc), it covers almost all dependencies by default. If your server/VPS is having minimal OS installation, you will need to look at the following required tools before proceeding with the installation.

  • Webserver e.g Apache, Nginx
  • MySQL 5.5 or higher (Suggested 5.7 or higher)
  • InnoDB Table Support
  • PHP 7.2 or higher
  • Cron Support

Required PHP Extensions

  • Ioncube10
  • OpenSSL
  • PDO
  • Mbstring
  • Tokenizer
  • XML
  • Ctype
  • JSON
  • BCMath
  • IMAP
  • SSH2
  • Curl
  • Iconv
  • Domdocument
  • Zip
  • Fileinfo

PHP Required Configuration

  • allow_url_fopen
  • url_include
  • exec
  • shell_exec
  • memory_limit (minimum 512M)
 

Files and Folders Permissions

You need to give writable (777) permissions recursively (all content inside including sub-folders and files) to the folders mentioned below.
 

  • \bootstrap\cache
  • \storage
  • .env (create this file if doesn't exist)


Whitelist Required IPs in Your Server’s Firewall (If needed)

Do whitelist the following ips on the mentioned ports permanently if you have a firewall running in your server. It will allow your Mumara to update on a single click when we have updates available.
 

Type

IP

Ports

Update Server

193.70.8.170

80, 3306

Licensing Server

45.33.83.168

80