Dockerized MySQL Crashes a Lot!

This blog is being hosted on a 5$/mo DigitalOcean droplet and it is served as Docker Humble project. Docker gave me pure freedom in my technology stack for a reasonable 60$/year price. I like it, a lot.

What I don't like is the tendency to crash that seems to be idiosyncratic to my setup. It's been going on since a couple of days: every works fine for a while, and then MySQL kinda crashes giving me a mysterious message:


So I wore my debugging hat and I started investigating the issue. In this article I'm going to place a link to the solution I found.

Please consider my background:

Give me the Solution, NOW!

Click here, this is the solution

(I plan to send flowers to that guy, it really made the whole thing simple to me)

How'd you get there?

Glad you asked, please take a seat and enjoy your flight!

I'm working on a tiny budget, but I aim for the stars!

In order to do my best in my current role I decided to learn something about WordPress. I despised it for long years but not it looks like I can't get rid of it, so I've embraced it.

Anyway I really hate the idea to spend money on MAMP Pro like I used to do in the past, today we have Docker and everything should be fast and easy thanks to tools like Docker Compose and Docker Humble.

I know I know, everybody says you shouldn't use Docker to manage state-full services like databases. I agree on that as best practice for big projects with a huge data load.

But here I'm running my small small blog, and the only thing I care about is to make it simple for me to manage. Therefore I run MySQL as part of my Docker Compose stack, straight into my production server.

Everything works fine on a 5$/mo DigitalOcean droplet, but for the fact that every now and then MySQL crashes and I can't figure out why!!!

  1. I'm not used to server management
    (I was just a humble front-end developer until yesterday)
  2. I am absolutely no familiar with process debugging

My wild guess is that is a memory problem:

  1. Just after I restart the project everything works just fine
  2. It holds for 24-48 hours (give or take)
  3. The container doesn't crash (I guess MySQL process doesn't crash either)
  4. WordPress just can't connect to the database anymore
  5. Other websites (waaay bigger than mine) that run on bigger servers don't have this problem

Actions I plan to take:

  1. Monitor my homepage to detect when it's down
  2. Figure out how to access MySQL logs
  3. Restart MySQL service every night if this helps to mitigate the problem

It's a Humble Setup:

First things first: I'm running a Dockerized WordPress application on a 512Mb DigitalOcean Droplet that I'm paying just 5$/mo. This is most probably too small to efficiently run the full setup and many friends told me just to move on to a bigger (aka: more expensive) setup.

Round1: Monitoring

The idea is to start to track down how often the problem manifest and to look for a pattern, at the same time I want to export MySQL logs so next time it'll go down I will be able to understand why, hopefully.

WordPress' ugly Error establishing a database connection gives us an HTTP 505 so I guess I can use some free online resources to monitor it:


I ran a quick search for free online monitoring services and I gave a go to UptimeRobot. It looks easy and it gives me 50 watchers that run every 5 minutes for free.

I expect to be notified as soon my blog goes down!

Round2: Logging

This is quite silly, but after some googling I realised docker-compose logs mysql is all you need to access MySQL logs.

I couldn't find any useful logs anyway.

Round3: MySQL Memory Consumption

I decided to follow up with the running out of memory lead and it turned out it was the right direction to go.

You can use a combination of docker-compose ps, docker-ps and docker stats to get the CPU, memory, net and disk i/o of your containers:


I didn't like what I saw.
MySQL allocated 200Mb of RAM just after booting up.

And we are talking of a blog with 10 small articles and no traffic at all. It's just a dummy project!

is Docker that bad?
or is MySQL thaaaaat bad?

no, that is NOT the case! It's just you being cheap on your server!

Again, I'm running on the smallest DigitalOcean droplets.
It's just 512Mb RAM for the entire virtual machine!

I am so used to almost unlimited resources on my MacBookPro that I tend to not take into account what 512Mb are: they ain't much!

The next obvious step is to figure out how to optimise my services to either consume less memory or reboot automatically over a critical threshold.

Round4: Memory Optimisation

My first attempt to optimise my setup was by shrinking down MySQL's Ram footprint. After some googling I traced down a couple of contradicting tutorials that claim to achieve the best possible memory footprint ever. Of course it was just a tiny bit more complicated than that, plus I don't know s**t about MySQL configuration.

I ended up building my own custom configuration file my.cnf:





I don't understand much of it.
However the first setting alone reduces the memory impact from ~200Mb to ~50Mb.

A second step was to limit container's memory in my docker-compose.yml:

version: '2'
      - ./services/mysql/my.cnf:/etc/mysql/my.cnf
    mem_limit: 50m
    restart: always

      mem_limit: 150m
      restart: always

That seemed to get the job done on my working machine,
so I promptly pushed to production.

Here are some personal observations:

I noticed that forcing ludicrously low memory limit Docker induces heavy I/O on the disk. The way I understand it is that Docker forces the process to swap memory to the permanent storage instead of crashing the container approaching memory limit. I'm not sure I have a good understanding of that and I plan to investigate more.

An interesting fact is that this behaviour causes almost no problems on my development machine, but it kills my containers on my DigitalOcean droplet.

At the moment of writing I'm giving 50Mb to MySQL and 150Mb to Apache and it looks like it's behaving quite good.

If this turns out to be a reliable setup I might be able to run 2 WordPress projects inside a 5$/mo droplet. That means 30$/year dedicated hosting, which is absolutely not bad compared to a shared hosting.

I can still add whatever library I may want and weird language or service to my setup. That's pure freedom for a ridiculous amount of money.

Round5: PHP-FPM

If you take a closer look at Docker WordPress you notice they have an Apache and FPM version.

What is _FPM anyway?_
I didn't know and I didn't care. I just thought it may be lighter than Apache so I tried it.

And I failed!

WordPress-FPM is not a drop in replacement for the Apache version. It requires some love and an NGiNX proxy to work. Fortunately some good guy did it already.

For what I could see WordPress-FPM is actually lighter that the Apache version but the setup hassle makes it not worth to me. I'm giving 5 minutes to each possible solution as this is just a personal project!

Remember? I'm running on a tiny tiny budget!

Round6: WordPress Image Optimisation

Next step involves another round of Googling. Now that MySQL memory is under control I would like to do achieve the same with Apache/Wordpress.

My query was straightforward and I regret not to have searched for it earlier as it produced the complete solution as first result: optimise docker wordpress memory


From now on is pure theory, but thank you for reading!
  • Thanks for this! This was really starting to irritate me – especially with how many people were telling me to just buy a bigger droplet. There is absolutely no excuse for a single WordPress site to crash on a half gig of memory. If I really wanted to spend 10 bucks a month, I’d just give my money to a managed WordPress hosting provider and call it a day – or just host it Windows Server.

    Anyway, thanks for the configs!

    • mpeg

      welcome Alex!