Install EmpireCMS

Procedure

EmpireCMS 7.5 requires PHP version 4.2.3 or later, but earlier than 8.0. Therefore, you must verify your Web Hosting instance's PHP version before installation.

1. Verify and set the PHP version for your Web Hosting instance.

   1. Log on to the Web Hosting console.

   2. Find your Web Hosting instance and click Manage in the Actions column.

   3. In the left-side navigation pane, choose Advanced Settings > PHP Version Settings.

      The page displays a list of available PHP versions, from PHP 5.2 to PHP 8.0. Select a version that meets the EmpireCMS requirements.

   4. If the current PHP version does not meet the requirements, select a supported version and click Save Settings.

      Important

      When you use PHP 5.3 or later, you must set the MySQL encryption mode to 41-bit. For more information about how to configure 41-bit encryption, see Reset the database password for a Web Hosting instance.

2. Obtain host information.

   1. In the left-side navigation pane, click Site Information.

   2. In the Site Information section, record the host information required for installation.

      The Site Information page includes sections such as server monitoring, website information, account information, and database information. Record the key information in the following three sections.

      Section	Description
      ①	Temporary domain name.
      ②	FTP login address, FTP username, and login password, used to log on to your FTP client.
      ③	Database name, database endpoint, database username, and database password, used to configure your website.

3. Use an FTP client to upload the contents of the upload directory from the downloaded EmpireCMS package.

   The web root directory for a Linux-based Web Hosting instance is /htdocs. You must upload the installation files to this directory.

   Choose an upload method based on the package size:

   • If the installation package is small, you can upload the files directly. For more information, see Upload website files to a Linux-based Web Hosting instance.
   • If the installation package is large, first compress the files and upload the package to the Web Hosting instance. Then, decompress the package in the Web Hosting console. For more information, see Compress and upload website files.
   Important

   Upload the contents of the upload directory, not the directory itself.

4. Install EmpireCMS.

   1. In the address bar of your browser, enter http://your_domain_name/e/install/index.php and press Enter.

   2. Read the license agreement and click I Agree.

      The installer displays the Empire CMS User License Agreement page.

   3. Review the environment information detected by the installer and click Next.

      The environment check page displays the results for the operating system, PHP version, MySQL support, PHP safe mode, GD library, and data collection functions. You can proceed with the installation after all checks are passed.

   4. Review the file permission settings and click Next.

      The file permission settings page lists the permission status for required directories and files, such as the root directory, attachment directory, cache directory, and configuration files. Make sure all items show as passed.

   5. Configure the database information and click Next.

      On the database configuration page, leave the MYSQL Interface Type set to its default, mysqli, and ensure the MYSQL Version is MYSQL 5.* or later. Keep the default values for other options, such as Table Prefix (phome_) and COOKIE Prefix.

      The main parameters are described in the following table.

      Parameter	Description
      Database Server	Enter the database endpoint obtained in Step 2.
      Database Username	Enter the database username obtained in Step 2.
      Database Password	If you forget the password, you can reset it. For more information, see Reset the database password for a Web Hosting instance.
      Database Name	Enter the database name obtained in Step 2.

   6. Set the administrator information and click Next.

      The administrator account settings page includes fields for Username (default: admin), Password (case-sensitive), Confirm Password, and Login Authentication Code (optional).