Troubleshooting cPanel & WordPress Migration: Fixing Common Issues for Nepali NGOs

Troubleshooting cPanel & WordPress Migration: Fixing Common Issues for Nepali NGOs

Migrating a WordPress website via cPanel can be challenging, especially for Nepali NGOs with limited technical resources. This guide helps you troubleshoot common issues like DNS propagation delays, missing files, database connection errors, and email problems during migration, ensuring a smooth transition for your online presence.

Key facts: * Primary Tool: cPanel (or similar control panel) for file and database management. * Critical Steps: Full backup, file transfer, database import, configuration update, DNS cutover. * Common Pitfalls: DNS caching, incorrect database credentials, missing wp-config.php updates, email re-configuration. * Cost Savings: Self-migration can save significant NPR for budget-conscious NGOs. * Recommended Provider: Hosting Nepal offers expert support for cPanel migrations.

Overview of cPanel WordPress Migration Challenges

Migrating a WordPress website from one hosting provider to another, even with cPanel, often presents unexpected hurdles. For Nepali NGOs, whose websites are crucial for outreach, fundraising, and community engagement, even minor downtime or data loss can be detrimental. Common challenges include understanding DNS propagation, ensuring all website files and the database are correctly transferred, and reconfiguring WordPress to work in its new environment. According to a 2025 survey by a local tech consultancy, nearly 40% of small organizations in Kathmandu face significant issues during self-managed website migrations, primarily due to lack of technical expertise and inadequate planning.

Many NGOs in Nepal rely on WordPress for its ease of use and extensive plugin ecosystem. However, this also means a WordPress migration involves not just files, but also a database and potentially complex wp-config.php settings. A successful migration requires careful attention to detail, from creating a comprehensive backup to updating DNS records and verifying site functionality post-transfer. Hosting Nepal regularly assists local organizations with these transitions, offering guidance and support to minimize disruption.

Common Troubleshooting Scenarios and Solutions

When your WordPress site isn't working as expected after a cPanel migration, it's usually one of a few common culprits. Here’s how to systematically identify and fix them.

1. Website Not Loading or Showing Old Content (DNS Issues)

This is perhaps the most frequent issue. After updating your domain's nameservers at your domain registrar (e.g., Nepal Telecom, Mercantile Communications) to point to your new hosting provider, your site might still show the old content or simply not load. This is often due to DNS propagation delays and local caching.

* Problem: Site shows old content or a "server not found" error. * Cause: DNS (Domain Name System) changes take time to update across the internet (propagation). Your local computer or ISP (like WorldLink, Vianet) might also be caching old DNS records. * Solution: * Wait: DNS propagation can take 24-48 hours. Be patient. * Clear Local DNS Cache: On Windows, open Command Prompt as administrator and type ipconfig /flushdns. On macOS, use sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder in Terminal. Restart your browser. * Check DNS Propagation: Use online tools like DNS Checker (dnschecker.org) to see if your domain's nameservers have updated globally. * Verify Nameservers: Double-check that you've entered the correct nameservers provided by your new host (e.g., ns1.hostingnepal.com, ns2.hostingnepal.com) at your domain registrar.

2. Database Connection Errors

WordPress relies heavily on its database. If the site loads but shows an "Error establishing a database connection" message, it means WordPress can't talk to its database.

* Problem: "Error establishing a database connection." * Cause: Incorrect database name, username, password, or host in wp-config.php. * Solution: * Locate wp-config.php: This file is in your WordPress root directory on the new server. * Verify Credentials: Open wp-config.php and check the DB_NAME, DB_USER, DB_PASSWORD, and DB_HOST values. These must exactly match the database credentials you created in cPanel on your new hosting account. * Database Host: For most cPanel setups, DB_HOST is localhost. If your host specifies something else (e.g., a specific IP address or hostname), use that. * Create/Verify Database: Ensure the database, user, and password exist and the user has all privileges on the database in your new cPanel's "MySQL Databases" section.

3. Missing Files or Incomplete Transfer

Sometimes, not all files get transferred during the cPanel backup and restore process, or permissions are incorrect.

* Problem: Images are broken, plugins don't work, or parts of the site are missing. * Cause: Incomplete file transfer, incorrect file permissions, or corrupted files. * Solution: * Re-upload: If using FTP, ensure all files and folders from your public_html directory (or WordPress installation directory) are uploaded to the new host. Pay special attention to the wp-content folder which contains themes, plugins, and uploads. * Verify wp-content: Check that all subfolders (themes, plugins, uploads) within wp-content have been transferred completely. * Check File Permissions: Incorrect file permissions can prevent the web server from reading files. Typically, folders should be 755 and files 644. You can often correct these via your cPanel File Manager or an FTP client. * Large Files: If you have very large media files, ensure they transferred fully. Sometimes, large transfers can time out.

4. Internal Server Errors (500 Error)

A 500 Internal Server Error is a generic message indicating something went wrong on the server, but it doesn't specify what.

* Problem: "500 Internal Server Error" displayed. * Cause: Corrupted .htaccess file, PHP memory limit issues, or faulty plugin/theme. * Solution: * Rename .htaccess: Access your site via cPanel File Manager or FTP. In your WordPress root directory, find the .htaccess file and rename it to something like .htaccess_old. Then, try loading your site. If it works, go to WordPress Admin > Settings > Permalinks and save changes twice to generate a new .htaccess file. Increase PHP Memory Limit: If you have a memory-intensive site, you might need more PHP memory. Add define('WP_MEMORY_LIMIT', '256M'); to your wp-config.php file above the / That's all, stop editing! Happy blogging. */ line. Alternatively, ask your hosting provider to increase it. * Disable Plugins/Themes: If the error persists, try disabling all plugins by renaming the wp-content/plugins folder to wp-content/plugins_old. If the site loads, rename it back and reactivate plugins one by one to find the culprit. Do the same for your theme if necessary.

5. Broken Permalinks or Redirect Issues

After migration, clicking on internal links might lead to 404 errors or redirect to the old domain.

* Problem: 404 errors on internal pages, or redirects to the old domain. * Cause: WordPress still has the old domain name stored, or .htaccess issues. * Solution: * Update WordPress URL: Log into your new WordPress Admin Dashboard (if possible). Go to Settings > General and update "WordPress Address (URL)" and "Site Address (URL)" to your new domain. Save changes. * Force Update Permalinks: Even if the URLs look correct, go to Settings > Permalinks and simply click "Save Changes" twice. This regenerates the .htaccess file and updates permalink rules. * Database Search & Replace: If you can't access the WordPress admin, you might need to perform a database search and replace. Use a tool like WP-CLI (if available on your hosting) or a plugin like "Better Search Replace" (after you get the site partially working) to replace all instances of olddomain.com with newdomain.com in your database. Be extremely careful with this step or ask your host for assistance.

6. Email Issues After Migration

NGOs rely heavily on email for communication. If your domain's email stops working after migration, it's a critical issue.

* Problem: Cannot send or receive emails for your domain (e.g., [email protected]). * Cause: MX records not updated, email accounts not recreated, or local email client settings still pointing to the old server. * Solution: Update MX Records: If you're using email services on your new hosting, ensure your domain's MX (Mail Exchanger) records at your domain registrar point to your new host's mail server. If you use a third-party email service (like Google Workspace, Zoho Mail), ensure the MX records still point to their* servers. * Recreate Email Accounts: You'll need to recreate all your email accounts (e.g., [email protected], [email protected]) in your new cPanel's "Email Accounts" section. * Update Email Client Settings: Inform your team to update their email client (Outlook, Thunderbird, mobile apps) settings to use the new incoming/outgoing mail server details provided by your new host.

How to Migrate WordPress with cPanel (Step-by-Step)

For NGOs in Nepal, a well-executed migration ensures continuity of services. Here's a concise guide to a smooth cPanel WordPress migration.

Step 1: Full Backup of Old Site

Always start with a complete backup. In your old cPanel, go to "Backup Wizard" or "Backups" and download a full website backup (including all files and databases). This typically creates a .tar.gz file for files and .sql files for databases. This is your safety net.

Step 2: Create New Hosting Environment

Log into your new hosting provider's cPanel. Create a new database and a new database user, assigning all privileges to the user for that database. Make sure to note down the database name, username, and password.

Step 3: Transfer Files to New Host

Upload your website files to the public_html directory (or your specific WordPress installation directory) on the new server. You can use cPanel's File Manager, FTP/SFTP, or if your new host has a "Restore" option in their cPanel, upload the full backup .tar.gz file there.

Step 4: Import Database

In your new cPanel, go to "phpMyAdmin." Select the newly created database and click on the "Import" tab. Choose your .sql backup file and proceed with the import. This populates your new database with all your WordPress content.

Step 5: Update wp-config.php

Edit the wp-config.php file in your WordPress root directory on the new server. Update the DB_NAME, DB_USER, DB_PASSWORD, and DB_HOST constants to match the new database credentials you created in Step 2.

Step 6: Update WordPress URLs in Database

This is crucial. Log into your new WordPress Admin (if accessible) and go to Settings > General. Update the "WordPress Address (URL)" and "Site Address (URL)" to your new domain. If you cannot access the admin, you'll need to use phpMyAdmin to manually update the siteurl and home options in the wp_options table (or whatever your table prefix is).

Step 7: Update Permalinks and Clear Cache

In your WordPress Admin, go to Settings > Permalinks and click "Save Changes" twice. This refreshes your .htaccess file. If you have caching plugins, clear their cache. If using a CDN, purge its cache.

Step 8: DNS Cutover

Finally, update your domain's nameservers at your domain registrar (e.g., NTA-approved registrars) to point to your new hosting provider. This is the DNS cutover. Remember that propagation can take 24-48 hours. During this time, you might see the old site, the new site, or nothing at all, depending on your location and ISP.

Step 9: Verify and Test

Thoroughly test your entire website. Check all pages, posts, images, forms, and any specific functionalities your NGO relies on. Ensure all internal links work, and test your contact forms. If you have an e-commerce component (for donations), test the payment gateways (Khalti, eSewa) rigorously.

Conclusion: Ensuring a Smooth Transition for Your NGO

Website migration, particularly a WordPress migration via cPanel, doesn't have to be a daunting task for Nepali NGOs. By understanding the common pitfalls and following a systematic troubleshooting approach, you can resolve most issues efficiently. Remember to always start with a full backup, meticulously update your wp-config.php and WordPress URLs, and be patient with DNS propagation. Hosting Nepal is committed to supporting local non-profits with reliable web hosting and expert guidance, ensuring your digital presence remains strong and uninterrupted.

If you encounter persistent issues, don't hesitate to reach out to your hosting provider's support team. A little preparation and a clear troubleshooting roadmap can save your NGO significant time and resources, keeping your vital online operations running smoothly.