# Installation Guide

# Prerequisites

Before you continue, make sure you have the following to hand:

  • Your Enhance licence key. You can register for a licence key here.
  • Your Enhance install command

TIP

If you have purchased a licence, these will have been sent to you by email. You will also be able to find these in your my.enhance account.

# Hardware Requirements

The minimum hardware requirements for installing Enhance are:

  • A blank full virtual machine or a bare metal server (minimum 2GB RAM, 20GB disk, 2CPU cores or vCPUs)
  • Ubuntu 24.04 LTS
  • x86_64/amd64 architecture

WARNING

ARM, containerised environments or any form of paravirtualized enviroment such as LXD or Virtuozzo are not supported.

All customer data resides in /var and we recommend, if your disk is partitioned, that this partition contains most of your available space.

TIP

If you are running mass hosting or a large number of websites you will require substantially more resources, particularly memory.

Additionally the hardware requirements will vary depending on the roles you have installed. For example, a database server may require higher i/o performance than a mail server.

If you do find that you outgrow a server which you have deployed, Enhance makes it easy to migrate website roles to new machines.

# Installation steps

  1. Log in to your new server;
    • as root via SSH or
    • as a user with sudo privileges and type "sudo -i"
  2. Copy and paste your Enhance installation command into the terminal.
bash -c "$(curl https://install.enhance.com/install.sh)"
  1. Hit Enter. This will trigger the installation process. Your system will install the necessary packages using the apt package manager.

  2. Once the installation is complete, a one time link will be displayed in your terminal. Visit the link to complete the setup in your browser. If you cannot access the URL provided, check if you have a hardware firewall on your control panel server and make sure to allow port 2087.

  3. Once you enter the Enhance panel, click settings then licence to enter your licence key.

  4. You can configure your admin credentials using the profile button at the top right of the control panel.

  5. If you forget your admin credentials, you can use sso from the command line. As root, run ecp sso.

  6. Optionally, you can configure a control panel domain to access the control panel in place of the IP. Go to settings then platform and enter your chosen domain.

  7. To add servers to your panel, click servers then add server. Paste the resulting command into the root terminal of the server to be added. This command is specific to your Enhance installation.

TIP

If the new server appears offline in your Enhance panel, check that any external firewall permits port 50000 from your control panel server IP.