Struggling to backup selfhosted fusionAuth.

Reply to Struggling to backup selfhosted fusionAuth. on Fri, 20 Feb 2026 15:43:51 GMT

ralph — Fri, 20 Feb 2026 15:43:51 GMT

Answering my own question here... turns out there was a version mismatch. Oh dear

To summarise...

Perform backups using pg_dumpall and hive them off the server somewhere. This gives you textual SQL files, if you prefer, pg_dump can do different things, but works on an individual database at a time.

I'd also recommend you setup your server using something like Ansible. It means that things like your properties file and other details will be the same next time you need to (re)install.

To restore:

Stop FusionAuth if it's running
Make certain FusionAuth is the same version as was used when the backup took place!
Go double-check those versions
Restore by running sudo -u postgres psql < dump.sql
Restart FusionAuth (not in silent mode)

For More sensitive environments, you may want to consider database replication and making a warm-standby server.

Reply to Struggling to backup selfhosted fusionAuth. on Mon, 23 Feb 2026 14:11:19 GMT

mark.robustelli — Mon, 23 Feb 2026 14:11:19 GMT

@ralph Thanks for following up and sharing!

Reply to Struggling to backup selfhosted fusionAuth. on Fri, 20 Feb 2026 15:43:51 GMT

ralph — Fri, 20 Feb 2026 15:43:51 GMT

Answering my own question here... turns out there was a version mismatch. Oh dear

To summarise...

I'd also recommend you setup your server using something like Ansible. It means that things like your properties file and other details will be the same next time you need to (re)install.

To restore:

Stop FusionAuth if it's running
Make certain FusionAuth is the same version as was used when the backup took place!
Go double-check those versions
Restore by running sudo -u postgres psql < dump.sql
Restart FusionAuth (not in silent mode)

For More sensitive environments, you may want to consider database replication and making a warm-standby server.

Reply to Struggling to backup selfhosted fusionAuth. on Fri, 20 Feb 2026 15:41:37 GMT

mark.robustelli — Fri, 20 Feb 2026 15:41:37 GMT

@ralph Are you getting the same errors? I did see a reference to trying pg_dump vs pg_dumpall. Can you try that and let us know if it works?

Reply to Struggling to backup selfhosted fusionAuth. on Fri, 20 Feb 2026 14:10:15 GMT

ralph — Fri, 20 Feb 2026 14:10:15 GMT

Did you ever get a solution to this? I've just hit the same problem.

In my case, I have a single server which failed, so I've re-installed (with the same version of FusionAuth as was on there before). I can let it run up as normal and it works fine, but if I restore my pg_dumpall backup, then I get the same errors as you.

I rather assumed that a postgres full backup was all I needed to do for DR, but are there other steps as well? This seems surprisingly under-documented

Reply to Struggling to backup selfhosted fusionAuth. on Mon, 03 Feb 2025 16:25:19 GMT

mark.robustelli — Mon, 03 Feb 2025 16:25:19 GMT

@spydmobile Are all the errors specifically about the CORSConfigurationCacheLoader or are there others?

@spydmobile said in Struggling to backup selfhosted fusionAuth.:

2025-01-31 16:33:45 fusionauth-1 | 2025-01-31 11:33:45.952 PM ERROR com.inversoft.scheduler.LogAndRetainFailureHandler - The scheduled service [class io.fusionauth.api.service.cache.CORSConfigurationCacheLoader] failed but will be re-run.
2025-01-31 16:33:45 fusionauth-1 | org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 2