====== Pi-Hole ======

The Pi-hole® is a DNS sinkhole that protects your devices from unwanted content, without installing any client-side software.

===== Installation =====


==== One-Step Automated Install ====


Those who want to get started quickly and conveniently may install Pi-hole using the following command:
<code>
curl -sSL https://install.pi-hole.net | bash
</code>
Piping to bash is a controversial topic, as it prevents you from reading code that is about to run on your system.

If you would prefer to review the code before installation, we provide these alternative installation methods.


==== Alternative 1: Clone our repository and run ====

<code>
git clone --depth 1 https://github.com/pi-hole/pi-hole.git Pi-hole
cd "Pi-hole/automated install/"
sudo bash basic-install.sh
</code>
==== Alternative 2: Manually download the installer and run ====

<code>
wget -O basic-install.sh https://install.pi-hole.net
sudo bash basic-install.sh
</code>

==== Alternative 3: Use Docker to deploy Pi-hole ====

Please refer to the Pi-hole docker repo to use the Official Docker Images.

===== Updating =====


Updating is as simple as running the following command:
<code>
pihole -up
</code>

===== Uninstalling =====

Pi-hole can be uninstalled using:
<code>
pihole uninstall
</code>