Troubleshooting

Clear DNS Cache

Cache is automatically cleared by restarting the FTLDNS service.

Settings › Restart DNS resolver

Failed Upgrade

This may happen with major changes between pi-hole versions, especially with FTLDNS; which may leave the system with a permenant DNS server not started error.

Backup all files in Files.

Reinstall the Pi-Hole server and setup vanilla. Then copy the following files to do a manual teleporter install. 5.x may be exported to 4.x flat files if needed. A teleporter install in 5.x will not carry over all settings.

Teleporter Install

Location

Purpose

/etc/hosts

Hostname resolutions

/etc/pihole/gravity.db

PiHole list/group/client settings

/etc/pihole/dhcp.leases

Current DHCP leases (optional)

/etc/pihole/pihole-FTL.db

SQLite DNS resolution log (optional)

Updated: None

Warning

setupVars.conf, pihole-FTL.conf and anything in dnsmasq.d are probably different if the upgrade failed. Diff these and make a determination to copy.

Restart Pi-Hole.