Barry Quiel for fixing the Python version. This may be the future of PSS!

To install Pi-hole SafeSearch (PSS), simply run the following commands in your pi-hole terminal (log into pi with ssh; pi hole should be set up and running).

1. Download the Pi-hole SafeSearch script:

   wget https://raw.githubusercontent.com/jaykepeters/PSS/master/Pi-hole_SafeSearch.sh

2. Move the script.

   sudo mv ./Pi-hole_SafeSearch.sh /usr/local/bin/

3. Make the script executable.

   sudo chmod a+x /usr/local/bin/Pi-hole_SafeSearch.sh

4. Enable Pi-hole SafeSearch:

   sudo Pi-hole_SafeSearch.sh -e

If you wish to not enforce SafeSearch on your network anymore, please follow the steps below to completely uninstall PSS

1. Pi-hole_SafeSearch.sh --disable
2. PSS creates the following files:

• /var/log/pss.log
• /etc/pss.ack
• /tmp/safesearch.txt
• /etc/dnsmasq.d/05-restrict.conf (Version < 2.0)
• /etc/dnsmasq.d/SafeSearch.conf

3. Version 2.1 will have the --uninstall option

• User has to type y/n to confirm
• All files will be deleted, including the script

• GET
  • /ssStatus.php/?/getStatus
  • /ssStatus.php/?/getStatus/{provider}
  • /ssStatus.php/?/getStatistics
  • /ssStatus.php/?/getStatistics/{provider}
• POST
  • /ssStatus.php/?/enable/{provider}&auth={KEY}
  • /ssStatus.php/?/disable/{provider}&auth={KEY}