Skip to content

Database recovery

If the gravity.db database has been damaged, Pi-hole offers two built-in methods to repair the database.


Try to recover a damaged gravity database file. Pi-hole tries to restore as much as possible from a corrupted gravity database. Run:

pihole -g -r recover


Create a new gravity database file from scratch. This will remove your existing gravity database and create a new file from scratch. If you still have the migration backup created when migrating to Pi-hole v5.0, Pi-hole will import these files. Run:

pihole -g -r recreate


This option is meant to be a last resort. Recovery is a fragile task consuming a lot of resources and shouldn't be performed unnecessarily.

Force Pi-hole to run the recovery process even when no damage is detected. Run:

pihole -g -r recover force