WordPress®, a web-based content management system, allows users to easily create a website or blog. This document describes how to install WordPress on your cPanel account.
In cPanel & WHM version 92 and newer, users can install WordPress through the WordPress Toolkit interface.
For instructions on how to install WordPress through WordPress Toolkit, read Plesk’s WordPress Toolkit documentation.
In cPanel & WHM version 70 through 90, users can install WordPress through the WordPress Manager interface.
For instructions on how to install WordPress through WordPress Manager interface, read our WordPress Manager documentation.
In cPanel & WHM version 90 and earlier, users can install WordPress as a cPAddon with cPanel’s Site Software interface (cPanel >> Home >> Software >> Site Software).
To install WordPress as a cPAddon, perform the following steps:
http://example.com/wordpress/directory, browse to the
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 Manually section below.
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.
Manual installations may encounter issues due to conflicting
.htaccess files or database connection errors:
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:
For more information, visit the WordPress website.
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).
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.