GN Latest News

Install EHCP Force.

Configure your router.
Install software on your PC to remotely access your server.
Run the EHCP force Pre-install Script. (Important)
Install EHCP Force.
Run the EHCP force Post-install Scripts. (Important)
Post Reply
Rob Swan
Site Admin
Posts: 73
Joined: Tue Oct 31, 2017 3:03 pm
Location: UK
Contact:

Install EHCP Force.

Post by Rob Swan »

EHCP force is the main software that we are going to install on your server, it controls almost everything to do with websites and email.

The EHCP force installer automatically installs several packages that we need, so we don’t have to mess about installing them manually.

So, lets get right to it.

Logon to your server using your PC and putty.

Copy this script.

Code: Select all

wget -O "ehcpforce_stable_snapshot.tar.gz" -N https://github.com/earnolmartin/EHCP-Force-Edition/releases/download/1.1.1.1/ehcpforce_stable_snapshot.tar.gz
tar -zxvf "ehcpforce_stable_snapshot.tar.gz"
cd ehcp
sudo bash install.sh
cd ..
NOTE: The EHCP force install script has changed slightly for Ubuntu 24.04.

Right click on the flashing cursor in Putty to paste it in. (not need to select paste, just right click to paste)

Press enter.

Image

The installer should start to run…

Image

You may need to press enter to run the last command in the script…… (sudo bash install.sh)

As always you may need to re-type your password.

The installer will continue…

Image

During the install process you may see this screen or similar.

Image

If you do see this screen, use the up and down arrow to highlight each package, then press the space bar to put a * in the brackets.

Make sure each package in the list is selected with a star in the brackets.

Next, press the TAB button on your keyboard to select the Ok option.

Image

Then press enter.

You may see a longer version of the same screen, with a scroll bar to the right.

Image

In this case you need to do the same thing and select everything in the list, but you must keep pressing the down arrow until the scroll bar is at the end.

Then press TAB to highlight the Ok option, and then enter.

In the future there may be other screens that pop up, if I see any new ones, I will add them to this topic.

First you be asked “Install EHCP Force Edition in unattended mode”

It is very important to say YES to this, so type Y and press enter.

Image

On screen you will be given some user names and passwords, you don’t need to make a note of these yet!

Image

Please note, the credential in the above screen shot are not mine, nor will they be the same as yours, they are just an example.

Next you be asked to enter a global email address for the panel.

For this a strongly recommend you use Admin@YourDomain.com (replace YourDomain.com with your actual domain name that you purchased for your server)

Type the email address and then press enter.

Image

Next you will be asked “Install extra software in addition to EHCP Force Edition”

Again, it is very important that you say YES to this, so type Y and press enter.

Image

Next you will be asked for your “Fully Qualified Domain Name” or FQDM. This is the domain name that you purchased for your server (without WWW etc) for example MyDomain.com.

So, enter your domain name and then press enter.

Image

You will now be asked “Would you like to install PolicyD” , say YES to this also (type y and then press enter)

Image

You will now be asked about your servers time zone.

Image

The chances are, you will need to change the time zone, so answer no to this (press n then press enter).

The system will now tell you what your time zone shoud be based on your IP address.

So, assuming this is correct answer yes (press y then press enter).

Image

Next, you be asked about the “Default web server software to install”, for this type apache and then press enter.

Image

The installation will now continue, which will take a while.

Image

If you notice any error messages scrolling past during the install, just ignore them, the installer has the power to fix most things without user intervention.

When the installer, completes you will be shown all the user names and password again.

Image

Open notepad on you PC, next with the mouse highlight the user credentials within PuTTY (this will copy them, no need to select copy or press any keys)

Image

Within Notepad, click on the Edit Menu, and then Paste.

Image

Image

Then using the file menu in Notepad save then user credential somewhere safe on you PC.

If you need to retrieve these details at any point in the future you can do so by logging into your server on your PC using PuTTY and typing the following command.

sudo cat /root/ehcp_info (press enter)

You may as always need to re-enter your password. This will display them on screen.

Image

IMPORTANT:

Before we are done, there is another package we need to install called Certbot-apache.

Certbot-apache, used to get installed with EHCP force, but for some reason that I personally don’t understand it does not anymore.

So, issue this command (in PuTTY).

sudo apt install -y certbot python3-certbot-apache

Image

As always you may need to retype your password.

Press, y (enter) to install it when asked.

Image

Ok, EHCP force has been installed on your server, so for now at least you can log out of PuTTY by typing exit and then pressing enter.

To test EHCP force open your web browser, and type your server local IP address into the address bar (press enter).

Image

If all went ok you will see the EHCP force default page.

Image

If you don’t see then default screen, you could try a server re-boot, to do this simply log back into your server using PuTTY and issue this command.

sudo shutdown -r now (press enter)

As always you may need to enter your password again.

Image

Once the server starts the shutdown process, PuTTY will give you an error message to tell you that it has lost the connection.

Image

You should click ok, and then close PuTTY using the cross in the top left corner (Windows close icon).

Give your server at least 5 minutes in order to fully complete the re-boot, then open your web browser and try again.

If it still does not work and you are 100% sure you typed the correct IP address into your browser, you should consider that your server’s hardware may have a fault or is not compatible. Also, it could be that you did something wrong, so it is worth checking through all the steps again.

If all else fails, then try again using a different old PC or Laptop as your server.

That it, we are all done here.


Last bumped by Rob Swan on Sun May 12, 2024 1:17 pm.
Post Reply