Page tree
Skip to end of metadata
Go to start of metadata

Overview

WordPress®, a web-based content management system, allows users to create a website or blog and hosting providers to manage updates through cPanel & WHM.

Install WordPress

cPAddons allow hosting providers to simplify and manage the installation and update of software for their users.

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 (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 (Home >> cPanel >> Install cPAddons Site Software).
  2. Select the cPanel Blogs WordPress checkbox.
  3. Click Update cPAddon Config.

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

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

To learn more about how to configure how the system handles cPAddons notifications and permissions, read our Tweak Settings - cPAddons Site Software documentation.

If available, users can easily install WordPress as a cPAddon with cPanel's Site Software interface (Home >> Software and Services >> Site Software).

To install WordPress as a cPAddon:

  1. Navigate to cPanel's Site Software interface (Home >> Software and Services >> Site Software).
  2. To receive a notice via email when the hosting provider installs WordPress, click here after the You currently are set to receive a notice when updates for your installs are available text.
  3. Click WordPress.

  4. Enter the requested information.

    1. To install WordPress directly into a domain's document root, leave the installation URL's path blank.

      Warning:

       This may overwrite any files already in the document root.

  5. Click Install.
    1. If your hosting provider moderates requests for WordPress installation, click Submit Moderation Request.
    2. Enter a note for your hosting provider, and click Submit Request.

  6. When the WordPress installation finishes, use your web browser to view the location that you entered in Step 4.
    • For example, if you installed WordPress in the http://example.com/wordpress/ directory, browse the http://example.com/wordpress/ location.

If WordPress is not available as a cPAddon, users can ask their hosting provider to add it, or they install WordPress directly themselves (see User installs WordPress directly).

If your hosting provider does not offer WordPress as a cPAddon, you can manually download WordPress from the WordPress website and install it on your site.

For more information, read installation instructions from WordPress and their cPanel-specific instructions on how to create a database for WordPress.

WordPress installation issues

Document root issues

Note:

In the following examples, the following statements are true:

  • example.com represents the domain name.
  • example represents the account name.
  • subdomain represents a subdomain's directory.
  • addon.com 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/addon.com
      • /home/example/public_html/subdomain
  • Only one domain or subdomain can host a WordPress installation in any /home/example/public_html directory.
  • 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/addon.com/wordpress

For more information, visit the WordPress website.

Database connection errors

If WordPress returns a database connection error, make certain 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 >> MySQL >> Databases).

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

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