Quick Installation

Start installing the Eenos control panel. This document contains the system requirements and installation procedures to set up Eenos high-performance hosting control panel.

System Requirements

Overview

This document provides the system requirements for installing Eenos high-performance hosting control panel.

Software Requirements

Eenos hosting panel currently supports the following operating systems. Eenos only supports server operating systems on LTS or Enterprise releases.

Operating System Version Architecture
Ubuntu Server 22.04 LTS (Jammy Jellyfish) 64-bit
Redhat Enterprize Linux (RHEL) 9.3 or higher 64-bit
RockyLinux 9.3 or higher  64-bit 
AlmaLinux 9.3 or higher 64-bit
CloudLinux 9.3 or higher 64-bit

You can install Eenos on bare metal servers, VPS/cloud servers, and dedicated servers running one of the above OS. 

 We support the Operating system until the end of life (EOL) of the respective OS provided by the OS vendors.

Hardware Requirements

The following hardware configuration is required to install the Eenos hosting control panel. These requirements are just for installing the control panel. For a production server, you may need a large enterprise-level hardware

Installation Type  CPU RAM Hard Disk
Default / Minimal  2 x  2.0 GHz 2 GB 4 GB
Full / Enterprise 4 x 3.0 GHz 4 GB 8 GB
Networking / IP Requirements

Your server must need internet access and a public IP address. Eenos installation is not tested behind VPN or private networked environments. 

IP V4 Address: Your server needs at least one  IPv4 address to install and use the Eenos hosting control panel.

IP v6 Address:  Eenos support IPv6 address. It is recommended to use an IPv6 address, if available.

Enabling an IPv6 IP address will help mobile and tablet users connect easily to your server from mobile networks, increasing website visibility.

Prepare Server

Overview

 This procedure will help you to get a fully deployed and secured eenos control panel. You may prepare your server as follows, before starting the installation on Eenos  Hosting  Control Panel.

Activate License

The first step is to activate a  License from your client area.   The eenos license is dedicated to your server's main IP address. Find the license ip of your server using the following command from the server shell prompt.

Using curl command

curl https://verify4.eenos.com/myip

Using Dig Command:

dig +short txt ch whoami.cloudflare @1.0.0.1

Using Curl:

curl api.ipify.org

This command will show the license IP on your server terminal. This IP may be an IPv4 or IPv6 IP. 

Make sure to active the license for the exact IP showing on the above command

Setup Hostname

Every server needs a hostname. You can set up the hostname from your server terminal using the following command 

hostnamectl set-hostname NAME

Here the NAME is the name of the host

Example:  Setup hostname as server100.myhosting.com

hostnamectl set-hostname server100.myhosting.com

After setting up the hostname, please point the IP of your hostname to your server  IP

Pointing  IP of your hostname will help to setup SSL certificate during the installation time. If not, self-signed ssl will be used. 

After pointing the IP of your hostname you can test it by sending a ping request to the host name from your desktop.

An example is given below. Assume the hostname is server100.myhosting.com and my server IP is 10.0.0.10

# ping server100.myhosting.com
PING server100.myhosting.com (10.0.0.10) 56(84) bytes of data.
64 bytes from server100.myhosting.com (10.0.0.10): icmp_seq=1 ttl=64 time=0.035 ms
64 bytes from server100.myhosting.com (10.0.0.10): icmp_seq=2 ttl=64 time=0.040 ms
64 bytes from server100.myhosting.com (10.0.0.10): icmp_seq=3 ttl=64 time=0.037 ms

The above example will show the correct IP and it will ensure the DNS  IP of the hostname is correct and can resolve from outside the server.

Firewall Configurations

Your server may come with a default firewall installed by the Operating system. This may be  firewalld  or ufw services. We recommend disabling the firewall services or Open the following ports in your server firewall.

21,22,25,53,853,80,110,143,443,465,587,993,995,3332,3333,4443,4444,5554,5555,

 Eenos supports CSF , APF , UFW, and Iptables firewalls. You can install any of these firewalls after installing the Eenos control panel.

SELinux Configurations for ( RHEL / AlmaLinux/RockyLinux/CloudLinux)

The SElinux is not compatible with Eenos installations. We recommend disabling the SElinux and rebooting the server before starting Eenos installations.

Please disable SElinux and reboot the server before installing RHEL, AlmaLInux, RockyLinux, or CloudLinux.

Installation

Start Installing Eenos Control Panel

This document describes the installation procedure of Eenos.

You can download the latest eenos auto installation tool from https://download.eenos.com/eenos-installer/ 

Login to your server over ssh. You need to be root to install the Eenos. If you are not a root user switch to root as follows,

sudo su -

Now change the  working directory to /usr/src

cd /usr/src

Download  Eenos Auto Installer

Download the auto-installer using the wget or curl command from the server ssh terminal.

Download using the wget command

wget -c https://download.eenos.com/eenos-installer/eenos-installer-latest.tar.gz

Download using the curl command

curl -O https://download.eenos.com/eenos-installer/eenos-installer-latest.tar.gz

You can also download the installer to your desktop from the download link and upload it to your server  over ssh

Extract the tar file and go to the extracted folder

tar -xzf eenos-installer-latest.tar.gz
cd eenos-installer/

Run installer

It is time to execute the installer. To see the available options, run the following command from the installation folder.

python3 setup.py -h
Copyright (C) 2023-2022, Eenos.com 
Eenos High Performance Hosting Control Panel

 _  _       _   __ 
|_ |_ |\ | / \ (_  
|_ |_ | \| \_/ __) 

Eenos auto installer tool
usage: setup.py [options] install 

Required:
  install               Install Eenos Hosting Control Panel

Option(s):
  --atos                Accept Eenos Software License(EPL) and Service Level Agreements
                        Eenos License (EPL) : https://eenos.com/epl
                        Service Level Agreements : https://eenos.com/sla
                        WARNING !!! : You are not allowed to use eenos 
                        without accepting the EPL and SLA
                         
  --email contact_email_address
                        Server contact email address
                        Default : eenos@demo.eenos.com
                         
  --ns nameservers      Comma separated list of default  nameservers
                        Default: change-me@no-ns.com,change-me@no-ns.net
                         
  --setupwebserver webserver_type, -sw webserver_type
                        Combination of web server you like to use 
                        Choose one , By default  we use nginxhttpd
                        nginx             , Install nginx only web server
                        httpd             , Install apache httpd web server
                        ols               , Install OpenLiteSpeed web server
                        olsvarnish        , install OpenliteSpeed and varnish cache
                        nginxhttpd        , Install nginx and apache httpd
                        nginxvarnish      , Install nginx with varnish cache
                        httpdvarnish      , Install httpd with varnish cache
                        nginxhttpdvarnish , Install nginx and httpd with varnish cache
                        nginxolsvarnish   , Install nginx and OpenLiteSpeed with varnish cache
                            
  -h, --help            Show this help message and exit.

It is recommended to use a server contact email and two name servers to set up the eenos control panel. If  you have the email address and name servers,  please use the following command to start the installation

python3 setup.py --atos --email EMAIL_ADDRESS --ns nameserver1,nameserver2 install

Example:  We are using server contact email as  admin@mycompany.com and nameservers as ns1.mycompany.com and ns2.mycompany.com.  Note:  the installation command is as follows,

python3 setup.py --atos --email admin@mycompany.com --ns ns1.mycompany.com,ns2.mycompany.com  install

You can also start the installer without contact email or nameservers. In that case, the installation tool uses dummy contact email and name servers. If you do so, the installation command will be as follows,

python3 setup.py --atos install

The installer set up the default web server combination as nginx+apache. You can choose a web server combination also. For example, if you like to set up a varnish+nginx+apache httpd server, the installation command will be as follows,

python3 setup.py --atos --setupwebserver nginxhttpdvarnish install

It will take some time to finish the eenos auto installer.  After finishing the installation,  you may need to set up the disk quotas  using the following tool

/usr/local/eenos/scripts/setupquota

It is recommended to reboot the server after the first installation.

Login to Eenos Control Panel

Eenos hosting control panel is a 3-tire  application.  It has the following login options,

1) WAP ( Web Admin Panel)

This is the root user control panel. It is for the server administrator. You need the root credentials to access the control panel.  This service uses the following ports to connect 

 WAP SSL Port: 5555  ( Recommended ), Login url is: https://your-server-hostname:5555/ 

WAP Non-SSL Port: 5554 ( Insecure ), Login  url is: http://your-server-hostname:5554/

2) RAPP( Reseller Control Panel  - Reseller APP)

This is the reseller control panel for managing clients. Only reseller accounts are allowed to log in to this portal.  The RAPP uses the following ports to connect. 

RAPP SSL Port: 4444  ( Recommended ), Login url is,  https://your-server-hostname:4444/ 

RAPP Non-SSL Port: 4443 (Insecure ), Login url is,  http://your-server-hostname:4443/

3) UAPP ( User  Control Panel  - User APP)

This is the end-user control panel for managing domains, emails, FTP, etc. Only sure accounts are allowed to connect to this portal. UAPP uses the following ports to connect

UAPP SSL Port: 3333  ( Recommended ), Login url is,  https://your-server-hostname:3333/ 

UAPP Non-SSL Port: 3332 (Insecure ), Login url is,  http://your-server-hostname:3332/

The non-ssl port will be redirected to SSL if your server has an ssl certificate installed on the hostname

.