f available, users can easily install WordPress as a cPAddon with cPanel's Site Software interface (cPanel >> Home >> Software and Services >> Site Software).
To install WordPress as a cPAddon, perform the following steps:
- Navigate to cPanel's Site Software interface (cPanel >> Home >> Software and Services >> Site Software).
- 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.
-
Click WordPress.
-
Enter the requested information.
-
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.
-
- Click Install.
- If your hosting provider moderates requests for WordPress installation, click Submit Moderation Request.
-
Enter a note for your hosting provider, and click Submit Request.
- 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 to thehttp://example.com/wordpress/URL.
- For example, if you installed WordPress in the
Important:
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. The new RPM-based WordPress cPAddon supports changes to WordPress plugins and themes. But you mustcontact your hosting provider to verify that they installed the new RPM-based WordPress cPAddon.
If WordPress is not available as a cPAddon, users can ask their hosting provider to add it, or they install WordPress directly themselves. For more information, read the User installs WordPress directly tab.
Note:
In cPanel & WHM version 64, we updated the cPAddons feature to use RPMs to install WordPress. In the latest release of the RPM-based WordPress cPAddon, we released cPanel's WordPress Manager interface (cPanel >> Home >> Applications >> WordPress Manager) as a cPanel plugin. The WordPress Manager interface allows you to manage the WordPress installations on your cPanel account. The WordPress Managerinterface only manages WordPress installations that you create with the RPM-based WordPress cPAddon.
WordPress installation issues
Document root issues
Note:
In the following examples, the following statements are true:
example.comrepresents the domain name.examplerepresents the account name.subdomainrepresents a subdomain's directory.addon.comrepresents 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
- The following are examples of document root directories:
- 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_htmldirectory.- The following examples demonstrate installations that use the
wordpresssubdirectory:
- 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
- Under the document root for the main domain:
- The following examples demonstrate installations that use the
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).
Note:
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.
