Installation Guide

Welcome to the THT Installation Guide! This installation guide will show you step-by-step how to install TheHostingTool on your WHM server! A gallery of the installation steps is available below.

Step 1: Upload

Method A: cPanel

You can use cPanel's File Manager to upload and extract the THT archive. Log into cPanel, enter the File Manager, navigate to the folder you want to install THT to, and click on Upload. Upload the file and go back to the File Manager. Click on the file, extract the archive and remove the documentation and ZIP archive. Enter the 1.2 folder created, select all files, move it to the directory you'd like THT to be in, navigate to the folder, then remove 1.2

Method B: FTP

Extract the 1.2 folder from the archive. Open it in your file manager (Windows Explorer, for example) and drag-and-drop all the contents into an FTP window. The FTP window should be connected to your server on your WHM site, and should be navigated to the folder you want TheHostingTool to be in. Filezilla is an FTP client you can use. On Linux, you will need to navigate to the folder you extracted the files to in the left-hand panel, then drag-and-drop the files and folders in.

Step 2: Create Database

Using phpMyAdmin, cPanel, command-line, etc., create a database for TheHostingTool. We'll name ours "THT" for our tutorial.

Step 3: Install

Open up your browser and load the site where THT is being set up. We will be in, let's say, http://localhost/tht

Make sure that the installer is set to "Install" and not "Upgrade." Click Next. You will be asked for MySQL details. For our example:

• Hostname: localhost
• Username: root (do not use root when actually setting up THT!)
• Password: (none) (add a password when actually installing THT!)
• Database: tht
• THT Prefix: tht_ (this doesn't have to be changed)

THT will now insert the data it needs to operate. Once that is completed, you will be in Step 4. For the THT URL, we need to use http://ourdomain.com/tht/ since we need the trailing slash and we can't use localhost as THT will link to localhost, which does not exist for most or all of your clients. Set up your username, password, email and name and you should be done!

Step 4: Finished!

You are now finished with your THT installation. You can now browse your THT site and begin configuring it (see below).

Upgrades

When upgrading, go to Step 3, but instead of selecting "Install" at the first step, select "Upgrade." Each upgrade may require removing or uploading new files. Read the Readme file in each upgrade before you proceed.