Solving common problems with failed WordPress installations (permission errors, failed database connections, etc.)

The WordPress installation process usually goes smoothly, but newbies may encounter some error prompts. These problems may seem complicated and complex, but they can be easily solved by finding the cause. This section summarizes the common problems of failed installations and specific solutions to help you quickly troubleshoot and complete the installation.

I. Database connection failure (the most common error)

misbehavior

The installation prompts: "Error establishing a database connection" or "Error establishing a database connection" and you cannot proceed to the next step.

Possible causes and solutions

1. Incorrectly filled in database information (in the case of 90%)
   • checkpoints: Whether the database name, user name, and password are the same as the record (case sensitive).
   • Workout steps：
     1. Log in to the Pagoda panel and go to the "Database" page to confirm the database name and user name.
     2. If the password is wrong, click "More" → "Change Password" to generate a new password and record it.
     3. Return to the installation page, refill with the correct information and submit.
2. Database host address error
   • checkpoints: Is the "database host" correct (almost always for newbies)localhost）。
   • Workout steps：
     1. DefaultlocalhostNo modifications are required.
     2. If the server provider specifies (e.g. some overseas hosts), fill in the address provided (e.g.mysql.example.com）。
3. Database service not started
   • checkpoints: Whether the MySQL service on the server is running properly.
   • Workout steps：
     1. Log in to the Pagoda panel and click on "Software Store" on the left side.
     2. Locate the MySQL installation and check if the status is "Running".
     3. If it is not running, click the "Restart" button to start the service.
4. Database user has no privileges
   • checkpoints: Whether the database user has permission to access the database.
   • Workout steps：
     1. Login to the Pagoda panel and go to "Databases" → Click on "Manage" after Databases and go to phpMyAdmin.
     2. Click on the top menu "User Accounts" to find the corresponding database user.
     3. Confirm that the user has "All Rights" to the target database, if not then re-authorize.

II. Permission error (unable to create file/write configuration)

misbehavior

The installation is interrupted by "Unable to write wp-config.php file" or "Unable to create directory".

Possible causes and solutions

1. Insufficient web directory permissions
   • checkpoints: Whether the permissions of the web root directory on the server are set correctly.
   • Workout steps：
     1. Log in to the Pagoda Panel, go to "Sites" → Find the corresponding site, and click "More" → "Privileges".
     2. Set "Directory Permissions" to 755If the "File Permission" is set to 644。
     3. Ownership options www(or the server's default runtime user), click Apply.
2. Manually create the wp-config.php file
   • If prompted for a configuration file that cannot be written, create it manually:
     1. On the Installation Errors page, click "Create Profile" and copy the code from the page.
     2. Login to Pagoda Panel, go to the root directory of your website, click "New File", name it as wp-config.php。
     3. Double-click the file to open the editor, paste the copied code and click 'Save'.
     4. Go back to the installation page and click "Proceed with installation" to continue.
3. File ownership error
   • checkpoints: Whether the file belongs to a running user of the server (e.g., a running user of Apache or Nginx).
   • Workout steps：
     1. In the Pagoda File Manager, check the website root directory and click Permissions.
     2. Change the "Owner" and "Groups to which you belong" to the server runtime user (usually the www Or nginx）。
     3. Check "Apply to subdirectories" and click "OK".

Third, the installation process is interrupted or white screen

misbehavior

Halfway through the installation, it suddenly gets stuck, the page goes blank (white screen), or "500 Internal Server Error" is displayed.

Possible causes and solutions

1. PHP version incompatibility
   • checkpoints: Whether the server PHP version meets the WordPress requirements (recommended 7.4 and above).
   • Workout steps：
     1. Log in to the Pagoda Panel, go to "Websites" → Find the corresponding website and click "PHP Version".
     2. Select PHP 7.4 or 8.0 (for best compatibility) and click 'Switch'.
     3. Switch and revisit the installation page.
2. Insufficient PHP memory limit
   • checkpoints: PHP memory limit is too low, causing the installation process to break.
   • Workout steps：
     1. Login to the Pagoda Panel, go to "Software Store" → Find the installed PHP and click "Settings".
     2. Go to "Profiles" and search for memory_limit, change the value to 128M Or 256M。
     3. Click Save to restart the PHP service.
3. Corrupt or incomplete installation files
   • checkpoints: The uploaded WordPress installation package is not corrupt.
   • Workout steps：
     1. Redownload the WordPress installation package from the official source (see section 7.1).
     2. Log in to the Pagoda panel and delete all files in the root directory of your website.
     3. Re-upload and unzip the new installation package (refer to section 7.2) and start the installation again.

IV. Other common errors and solutions

1. Domain name not resolving or server port not open
   • misbehavior: The installation page cannot be opened when accessing the domain name, showing "Unable to access this site".
   • Workout steps：
     1. Check that the domain name has resolved to the server IP (refer to Section 4.4).
     2. Log in to the server console and verify that ports 80 (HTTP) and 443 (HTTPS) are open.
     3. If accessing via IP, verify that the Pagoda Panel does not restrict IP access.
2. Database table prefix conflicts
   • misbehavior: Prompts "Table already exists" or data is messed up after installation.
   • Workout steps：
     1. If WordPress was previously installed, log into phpMyAdmin and delete the old database tables.
     2. or modify the table prefixes during installation (e.g., change the wp_ change into wp2023_）。
3. Firewall or security plug-in blocking
   • misbehavior: The installation page loads slowly or is blocked.
   • Workout steps：
     1. Temporarily disable the server firewall or security group rules (turn them back on after the installation is complete).
     2. If you are using a domestic server, check if it is blocked due to filing issues (port 80/443 is not available for unregistered domains).

General tips for troubleshooting errors

1. Viewing the Error Log
   • Login to Pagoda Panel, go to "Sites" → "Logs" of the corresponding site, and check "Error Log", which will record the specific error reasons.
2. Simplified installation environment
   • If a complex server configuration is used, temporarily restore the default settings (e.g. PHP extensions, pseudo-static rules, etc.).
3. call for help
   • Copy the text of the error message and search for a solution in a search engine (you can usually find solutions to similar problems).
   • Contact the server provider's customer service and provide screenshots of the error so that a technician can assist in troubleshooting.

wrap-up

Most of the installation failures are caused by incorrect information filling, improper privilege settings or incompatible environments, following the methods in this section to check one by one, 99% problems can be solved. If multiple attempts still fail, it is recommended to reorganize the process: from database creation, file uploading to filling in the information, double-check each step to ensure that the operation is correct.

Once you've solved the problem, you're well on your way to getting into the WordPress backend and starting to build your website.