# Quick Installation

# 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.

<table border="1" id="bkmrk-operating-system-ver" style="border-collapse: collapse; width: 100%; height: 178.508px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.7612px;"><td style="height: 29.7612px;">**Operating System**</td><td style="height: 29.7612px;">**Version**</td><td style="height: 29.7612px;">**Architecture**</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">Ubuntu Server</td><td style="height: 29.7612px;">22.04 LTS (Jammy Jellyfish)</td><td style="height: 29.7612px;">64-bit</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">Redhat Enterprize Linux (RHEL)</td><td style="height: 29.7463px;">9.3 or higher</td><td style="height: 29.7463px;">64-bit</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">RockyLinux</td><td style="height: 29.7463px;">9.3 or higher </td><td style="height: 29.7463px;">64-bit </td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">AlmaLinux</td><td style="height: 29.7463px;">9.3 or higher</td><td style="height: 29.7463px;">64-bit</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">CloudLinux</td><td style="height: 29.7463px;">9.3 or higher</td><td style="height: 29.7463px;">64-bit</td></tr></tbody></table>

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

<p class="callout success"> We support the Operating system until the end of life (EOL) of the respective OS provided by the OS vendors.</p>

##### 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

<table border="1" id="bkmrk-installation-type-%C2%A0c" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td class="align-center">**Installation Type**</td><td class="align-center"> **CPU**</td><td class="align-center">**RAM**</td><td class="align-center">**Hard Disk**</td></tr><tr><td>Default / Minimal</td><td class="align-center"> 2 x 2.0 GHz</td><td class="align-center">2 GB</td><td class="align-center">4 GB</td></tr><tr><td>Full / Enterprise</td><td class="align-center">4 x 3.0 GHz</td><td class="align-center">4 GB</td><td class="align-center">8 GB</td></tr></tbody></table>

##### 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.

<p class="callout info">Enabling an IPv6 IP address will help mobile and tablet users connect easily to your server from mobile networks, increasing website visibility.</p>

# 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**

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

**Using Dig Command:**

```bash
dig +short txt ch whoami.cloudflare @1.0.0.1
```

**Using Curl:**

```bash
curl api.ipify.org
```

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

<p class="callout warning">Make sure to active the license for the exact IP showing on the above command</p>

### Setup Hostname

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

```bash
hostnamectl set-hostname NAME
```

Here the NAME is the name of the host

Example: Setup hostname as <span style="text-decoration: underline;"><span style="color: rgb(0, 0, 0); text-decoration: underline;">**server100.myhosting.com**</span></span>

```
hostnamectl set-hostname server100.myhosting.com
```

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

<p class="callout success">Pointing IP of your hostname will help to setup SSL certificate during the installation time. If not, self-signed ssl will be used. </p>

<p class="callout info">After pointing the IP of your hostname you can test it by sending a ping request to the host name from your desktop.</p>

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

```bash
# 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.

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

<p class="callout info"> Eenos supports **CSF , APF , UFW,** and **Iptables** firewalls. You can install any of these firewalls after installing the Eenos control panel.</p>

#### 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.

<p class="callout danger">Please **disable SElinux** and reboot the server before installing RHEL, AlmaLInux, RockyLinux, or CloudLinux.</p>

# 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/ ](https://download.eenos.com/eenos-installer/ "Download auto 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,

```bash
sudo su -
```

Now change the working directory to /usr/src

```bash
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**

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

**Download using the curl command**

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

<p class="callout info">You can also download the installer to your desktop from the download link and upload it to your server over ssh</p>

Extract the tar file and go to the extracted folder

```bash
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.

```bash
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

```bash
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,

```bash
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,

```bash
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,

```bash
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
```

<p class="callout info">It is recommended to reboot the server after the first installation.</p>

### 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/](https://your-server-hostname:555/)

**WAP Non-SSL Port: 5554** ( Insecure ), Login url is: [http://your-server-hostname:5554/](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/ ](https://your-server-hostname:4444/)

**RAPP Non-SSL Port: 4443** (Insecure ), Login url is, [http://your-server-hostname:4443/](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/](https://your-server-hostname:3333/)

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

<p class="callout info">The non-ssl port will be redirected to SSL if your server has an ssl certificate installed on the hostname</p>

.