How To Install WordPress

How To Install WordPress


Install the WordPress cPAddon

In order to allow users to install WordPress as a cPAddon, hosting providers must enable the WordPress cPAddon via WHM’s Install cPAddons Site Software interface (WHM >> Home >> cPanel >> Install cPAddons Site Software).

To enable WordPress installations as a cPAddon, perform the following steps:

  1. Navigate to WHM’s Install cPAddons Site Software interface (WHM >> Home >> cPanel >> Install cPAddons Site Software).
  2. Select the WordPress row’s checkbox.


    We deprecate WordPress (legacy) cPAddon in cPanel & WHM version 64 and disabled the it in version 70. cPanel & WHM servers now automatically create new installations with cPAddon’s RPM-based WordPress installation package that we added in cPanel & WHM version 64. To read more information about the cPanel & WHM deprecation schedule, read our cPanel Deprecation Plan documentation.

  3. Click Update cPAddon Config.


In cPanel & WHM version 64, we updated the cPAddons feature to use RPMs to install WordPress. When you install the WordPress cPAddon, the cPAddon also installs the WordPress Manager cPanel Plugin. This plugin includes the WordPress Manager interface (cPanel >> Home >> Applications >> WordPress Manager). The WordPress Manager interface allows you to manage the WordPress installations on your cPanel account. We only provide this plugin with the new version of the WordPress cPAddon.

Enable Moderation


In cPanel & WHM version 66, we deprecated the moderation feature and will remove it in the future. You cannot enable moderation for any cPAddons. Any cPAddons that currently use moderation will continue to function but, if you disable it, you cannot reactivate moderation.

To moderate installations for the WordPress cPAddon, perform the following steps:

  1. Navigate to WHM’s Manage cPAddons Site Software interface (WHM >> Home >> cPanel >> Manage cPAddons Site Software).
  2. Select the cPanel::Blogs::WordPress checkbox.
  3. Click Update Moderation.


For the WordPress (legacy) cPAddon, you must not modify or delete the default WordPress plugins and themes that the cPanel installation provides. WordPress will not update properly if you modify any of these files.

For more information about how the system handles cPAddons notifications and permissions, read our Manage cPAddons Site Software documentation.

WordPress installation issues

Document root issues


In the following examples, the following statements are true:

  • represents the domain name.
  • example represents the account name.
  • subdomain represents a subdomain’s directory.
  • represents an addon domain name.

Due to potential conflicts in the .htaccess file, do not configure multiple WordPress installations to share a single document root.

If you experience difficulties with WordPress, check the following requirements:

  • Each cPanel account user can host only one installation of WordPress in the document root directory.
    • The following are examples of document root directories:
      • /home/example/public_html/
      • /home/example/public_html/
      • /home/example/public_html/subdomain
  • Each directory may only contain one WordPress installation.
  • If the subdirectories are not a document root, cPanel account users can install additional WordPress installations in subdirectories under the domain’s home/example/public_html directory.
    • The following examples demonstrate installations that use the wordpress subdirectory:
      • Under the document root for the main domain: /home/example/public_html/wordpress
      • Under a subdomain: /home/example/public_html/subdomain/wordpress
      • Under an addon domain: /home/example/public_html/

For more information, visit the WordPress website.

Database connection errors

If WordPress returns a database connection error, ensure that the database’s name and password in the wp-config.php file are identical to the database credentials in your account.

For a document root installation, the wp-config file exists in the /home/username/public_html directory, where username represents the cPanel account name.

To change the database’s username or password, use cPanel’s MySQL Databases interface (cPanel >> Home >> Databases >> MySQL Databases).


If your hosting provider installed the new RPM-based WordPress cPAddon, you can use cPanel’s WordPress Manager interface (cPanel >> Home >> Applications >> WordPress Manager) to update your WordPress database user’s password.

To test a username and password combination, run the following command (where db_user represents the database’s authorized username):

mysql -u db_user -p

After you enter the command, enter the user’s password. The system will respond with a success or failure message.

About the Author

Leave a Reply