Installation

Introduction


The following tutorial assumes you've read the HostBill Requirements (System requirements) section and have configured your server to permit HostBill to function correctly.

Note

You can use automated install script that comes with all current HostBill editions. This script automatically installs, php-fpm, nginx , mysql(mariadb) database, and HostBill with all dependencies for you, along with initial configuration, cron setup and Additional security steps

All you need to do is run one bash command on your fresh install of one of:

  • CentOS Linux 8.x or 9.x
  • CentOS Stream 8.x or 9.x
  • AlmaLinux 8.x or 9.x
  • Rocky Linux 8.x or 9.x

Installation instructions / command to use for this fast method are emailed automatically after HostBill purchase.


Before Installing HostBill


Database Setup

  1. Create a database.
  2. Create a database user.
  3. Add the user to the database and grant all permissions / privileges.

File Preparation

  1. Download the HostBill files from our client portal after logging in.
  2. Upload the HostBill files to your domain's public directory.
  3. Extract the files in the same directory.
  4. Rename the includes/config.php.example file to includes/config.php.
  5. CHMOD /templates_c folder and config.php to 777.

Installing HostBill


Install HostBill

  1. Visit www.yourdomain.com/install/index.php replacing yourdomain.com with your HostBill's installation location.
  2. For this example, we're going with Standard Installation. Click that.
  3. Read and Accept the terms by clicking Agree.
  4. Leave localhost the same unless your database is located on another server.
  5. Enter the database name, database user, and database password.
  6. Click Check to test your connection, then wait for HostBill to install.
  7. Paste your License Activation Code in the license key field.You can purchase a license key by Clicking Here.You can find your license by Clicking Here after logging in.
  8. Click Activate. Your HostBill license is now successfully installed and activated.

By default, the HostBill username and password are admin. You'll have to follow the next few steps to change them. Login to HostBill and continue with the post-installation steps.


IMPORTANT

Protect contents of includes/config.php file at all costs.

During installation HostBill generates $ccEncryptionHash inside of it which is used as partial key for passwords encryption, if you'll loose/replace this variable's value, you will also loose all stored passwords.

Post Install & Cleanup


HostBill has a Country Profile feature to get you started. You can select a profile, or click Cancel to customize your profile yourself. If you're from any of the countries included in the country profiles, it's suggested you select a country profile to speed setup. Country profiles automatically setup correct GST, HST, and VAT taxes and do some of the early stage work for you.

It's time to cleanup your HostBill installation.

  1. Delete or rename the /install folder from your domain's directory.
  2. CHMOD /includes/config.php to 444.
  3. CHMOD /admin/cron.php to 755.
  4. CHMOD /admin/pipe.php to 755.
  5. CHMOD /queue.php to 755.

It's time to change your HostBill's password. Click on My Account within the HostBill administrative control panel located at the top right and edit your admin settings. Choose a strong password, then click Save.

Automation / cron setup


To finalize setup, you'll need a properly functioning cron job. Refer to Automation/cron setup article


You're now ready to start using HostBill. Refer to the security guidelines for further enhancements.