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
.