Backing up Discourse with RDS

| community | devops | aws |

We are launching a community site with Discourse at CircleCI and I ran into some issues with performing backups.

Since we want to be #webscale, rather than installing Discourse using the easy Docker method, we opted to split up the services on AWS.

We are using EC2, RDS, ElasticCache, ELB and S3 for backups. When I initially launched PostgreSQL on RDS I just picked the latest version (9.4 at time of writing) and didn’t put much thought into it. The problem is that the version of pg_dump inside the Docker container provided by Discourse is 9.3.  Apparently you are not able to do a pg_dump when your client and server are mismatched.

When you try to do this, you get a sad error that states:

aborting because of server version mismatch

In order to fix this, we need to upgrade the client version on the Docker container (or alternatively avoid this all together by using the same version of PostgreSQL on RDS). Since it is easier to update the client than downgrade RDS, I opted to upgrade the client.

To do this:

  1. Log into the EC2 Instance that is running Discourse
  2. Go to the Discourse install location (mine is in /var/docker)
  3. Enter the container with:
    sudo ./launcher enter app
    
  4. Upgrade the version of PostgreSQL client
    apt-get install postgresql-9.4
    
  5. Swap out the pg_dump symbolic link for the newer version
        ln -s /usr/lib/postgresql/9.4/bin/pg_dump /usr/bin/pg_dump
    
  6. Perform your  backup
When you update the Docker container for the next release you will likely have to repeat these steps until Discourse gets to the same version of PostgreSQL as the one you chose on RDS.

Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.

Check out some more stuff to read down below.

Most popular posts this month

Recent Favorite Blog Posts

This is a collection of the last 8 posts that I bookmarked.

Articles from blogs I follow around the net

My last 5 books - July 2026 edition

My last 5 books - July 2026 edition This is a new feature in which I will copy and paste my recent book reviews from my books page These are the last 5 books I have read. I will update in a month or 2 when I've read 5 more. I'm Starting to Worry About this...

via O'DonnellWeb July 12, 2026

“Animating something and animating something well are two very different things.”

From Jakub Krehel, a new blog post about self constraint in the era when AI makes it easy to ignore constraints altogether. My caveat is that the post doesn’t fully come together for me – jumping from AI to animations and then back to AI the way the author...

via Unsung July 12, 2026

Generated and suppressed demand.

Eight years ago, I wrote about my theory of restoring struggling teams, which came down to four steps: A team is falling behind if each week their backlog is longer than the week before. Solve by hiring more. A team is treading water if they’re able to get...

via Irrational Exuberance July 11, 2026

Generated by openring