ThisCalculator

Everyday

Add Manually Installed WordPress to Hosting Dashboard

Updated · Standard formula, shown below

If you uploaded WordPress files to your server via FTP or a file manager instead of using a one-click installer, your hosting dashboard may not show it as an installed site. This guide walks you through linking that manual installation to your hosting control panel, so you can manage updates, backups, and settings from one place.

What You’ll Need

  • Access to your hosting control panel (cPanel, Plesk, or a custom dashboard).
  • Your FTP or file manager login credentials (usually the same as your hosting account).
  • The database name, username, and password you used during the WordPress installation.
  • The domain name and the directory where WordPress is installed (e.g., public_html or a subfolder).

Step-by-Step

  1. Log in to your hosting dashboard. Open your hosting provider’s website and sign in with your account credentials. The dashboard is typically the first screen you see after logging in.
  2. Locate the “Websites” or “Sites” section. Most dashboards have a tab or icon labeled “Websites,” “Domains,” or “My Sites.” Click it to see a list of domains associated with your account.
  3. Find the domain you used for your manual installation. If your domain is already listed, it may show as “Not Installed” or “Unmanaged.” If it is not listed, you may need to add it first (see step 4).
  4. Add the domain if it’s missing. Look for a button like “Add Site,” “Add Domain,” or “Create New Site.” Enter your domain name and choose the document root (usually public_html or a subfolder). Save the changes.
  5. Look for a “Manage” or “Settings” option next to your domain. Click it to open the site management page.
  6. Find the “WordPress” or “Installation” section. Some dashboards automatically detect a manual WordPress installation by scanning the directory. If you see a message like “WordPress detected,” click “Connect” or “Manage.”
  7. If not detected, use the “Import” or “Connect Existing Installation” feature. Many dashboards offer an option to import an existing installation. You will be asked for the directory path, the database name, and the database credentials. Enter the details from your wp-config.php file.
  8. Enter the database details. If prompted, provide the database name, username, and password. These are found in your wp-config.php file under DB_NAME, DB_USER, and DB_PASSWORD.
  9. Save and wait for the dashboard to verify the installation. The dashboard will check that the database connection works and that the WordPress files are present. This usually takes a few seconds.
  10. Confirm that the site now appears as “Managed” or “Installed.” After verification, your dashboard should show the site with options like “Update,” “Backup,” or “Security.” If not, refresh the page.

Common Mistakes

  • Using the wrong directory path. If you installed WordPress in a subfolder (e.g., public_html/blog), but your domain points to public_html, the dashboard may not detect it. Double-check the exact path.
  • Entering incorrect database credentials. A typo in the database name or password will cause the connection to fail. Copy the values directly from wp-config.php.
  • Forgetting to update the site URL in the database. If you moved the site from a local server, the siteurl and home options in the wp_options table may still point to the old domain. This can cause the dashboard to think the site is not installed.
  • Assuming the dashboard will auto-detect everything. Some dashboards require manual import. If you don’t see an option, look for a “Connect” or “Import” button in the site settings.

Tips

  • Back up your wp-config.php file before making any changes. This file contains sensitive database credentials, and a mistake can lock you out.
  • Use the same database credentials in the dashboard as in your wp-config.php. Do not create a new database unless you plan to migrate the data.
  • After connecting, run a WordPress update from the dashboard. This confirms that the integration is working and that the dashboard can manage files.
  • If your dashboard offers a “Sync” or “Refresh” button, use it after making changes to your site files. This forces the dashboard to re-scan the directory.

Troubleshooting

  • The dashboard says “No WordPress installation found.” Check that the directory path is correct and that the WordPress files are actually there. Use the file manager to verify that wp-load.php exists in the root folder.
  • Connection fails due to database errors. Verify that the database exists and that the user has all privileges. You can test the connection using a tool like phpMyAdmin or by creating a temporary PHP file with mysqli_connect().
  • The site appears but shows an error when you try to manage it. This often happens when the dashboard cannot write to the filesystem. Check file permissions: directories should be 755 and files 644.
  • You see a “redirect loop” or “too many redirects” error after connecting. This is usually a caching issue. Clear your browser cache and any caching plugins. Also, check that the siteurl and home options in the database match your domain.
  • The dashboard shows the site but updates fail. This may be due to missing FTP credentials in the dashboard’s update settings. Some dashboards require you to enter FTP details for automatic updates. Look for a “FTP/SSH” section in the site settings.

Frequently Asked Questions

Do I need to reinstall WordPress to add it to the dashboard?

No, you can usually import or connect an existing installation without reinstalling. The dashboard will simply take over management of the existing files and database.

What if my hosting dashboard doesn’t have an “Import” option?

Some dashboards only support their own installer. In that case, you may need to manually create a new installation and then migrate your content using a plugin like Duplicator or by exporting/importing the database and files.

Will connecting a manual installation delete my existing content?

No, connecting should not delete anything. It just establishes a link between the dashboard and your existing files. However, always back up before making any changes.

Can I add a WordPress site that is in a subdirectory?

Yes, but you need to specify the correct subdirectory path when importing. For example, if your site is at example.com/blog, the path would be public_html/blog.

Why does my dashboard show the site as “Unmanaged”?

This usually means the dashboard detected the files but cannot manage them, often due to missing database credentials or file permission issues. Try re-entering the database details or adjusting file permissions.

What if I don’t remember my database password?

You can reset the database user password from your hosting dashboard (look for “MySQL Databases” or “Database Users”). Then update the wp-config.php file with the new password and use that same password when connecting.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.