WordPress Installation Problem Error Establishing A Database Connection

james swafford
A Personal Blog About Nothing in Particular

Error Establishing Database Connection in WordPress

My website (and a couple others on the same server) had been plagued with this mysterious ‘Error Establishing Database Connection’ for several weeks. I actually thought I had exhausted the system resources of my small web server and probably needed to upgrade it (add more RAM). I hadn’t considered the possibility that something more devious was going on, but it turns out my WordPress installation was vulnerable and was being 0wned!

This particular attack utilized the XML-RPC capabilities of WordPress. RPC is short for ‘Remote Procedure Call’. It’s a mechanism to execute procedures on a remote computer as if you were running locally. It’s a pretty powerful mechanism, but can be fairly dangerous too.

There are a few fixes published on the Internet. One solution was to enable Jetpack‘s security features. I tried it and it didn’t work. What did work for me was a two fold strategy.

1. Use a firewall to specifically deny the IP addresses of the attackers. I would consider this the first line of defense — it works at the lowest possible level. The problem with the Jetpack solution is that it works at the application tier, which consumes more system resources, leaving you open to denial-of-service type attacks.

I’m running Apache on an Ubuntu server. To find the IP addresses of the attackers, I did something like this:

fgrep ‘"POST /xmlrpc.php HTTP/1.0" 500 585 "-" "Mozilla/4.0 (compatible: MSIE 7.0; Windows NT 6.0)"’ /var/log/apache2/access.log | cut -d’ ‘ -f1 | sort | uniq

Once I had the IP addresses I installed Uncomplicated Firewall, and added a rule for each IP address.

sudo ufw insert 1 deny from
sudo ufw insert 1 deny from
sudo ufw insert 1 deny from

That alone helped dramatically, but doesn’t stop someone coming in from another address, so another step was needed.

2. I explicitly reject any web request for xmlrpc.php. You can do this using an .htaccess file, or directly in the web site configuration (in my case in /etc/apache2/sites-enabled). I added the following snippet to the bottom of the virtual host file(s). (I believe you could also do this globally if you didn’t want to do it per-site.)

Note, this disabled XML-RPC and therefore any features/plugins that require it! However, it works fine for my purposes. YMMV!

A question can only have one accepted answer. Are you sure you want to replace the current answer with this one?

You previously marked this answer as accepted. Are you sure you want to unaccept it?

Scalable compute services.

Worry-free setup & maintenance.

Simple object storage.

Run managed Kubernetes clusters.

Easily distribute traffic.

Attach scalable volumes.

Deploy pre-built applications.

Connect, share and learn

DevOps and development guides

Development and systems Q&A

by Justin Ellingwood

"Error establishing a database connection" on a new WordPress site?

If you have 512MB ram – add 1024MB swap file.

In tutorial above swap is 256MB. Create 1024MB file like this:
dd if=/dev/zero of=/swapfile bs=1M count=1000

This seems like a common issue. I’ve contacted DO support sever times. First I was told it was due to noisy neighbors, then I was told it might be something wrong on my end. I guess—plugins. My 1gb ram droplet typically uses 5%-10% CPU, then randomly, every 1-4 days, my server gets hit with 80%-100% CPU spike. This is when I receive the database connection error.

My site has low traffic. I use WP Super Cache to only dump cache once per day. I am also using serverpilot.io to manage my WP install. I’ve followed their suggested settings. https://serverpilot.io/community/articles/how-to-install-wp-super-cache.html

The cache dumping time does not match the CPU spike time.

It also seems swap is enabled.

Running sudo swapon -s
returns the following:
“`Filename Type Size Used Priority
/swapfile file 524284 0 -1

Leave a Reply

Your email address will not be published. Required fields are marked *