> For the complete documentation index, see [llms.txt](https://alerodriguezm99.gitbook.io/bariho/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alerodriguezm99.gitbook.io/bariho/proyectos/home-lab/pi-hole.md).

# 🍓PI-HOLE

{% tabs %}
{% tab title="¿Qué es PI-HOLE?" %}
Pi-hole es una aplicación para bloqueo de anuncios y rastreadores en Internet​​​​ a nivel de red en Linux que actúa como un sumidero de DNS​, destinado para su uso en una red privada.
{% endtab %}

{% tab title="REQUISITOS" %}

#### HARDWARE

* Mínimo 2GB , Recomendado 4GB de espacio libre.
* 512Mb de ram
  {% endtab %}

{% tab title="SOFTWARE" %}

<table data-view="cards"><thead><tr><th>Distribución</th><th>Release</th><th>Arquitectura</th></tr></thead><tbody><tr><td>Raspberry Pi OS</td><td>Buster/Bullseye</td><td>ARM</td></tr><tr><td>Ubuntu</td><td>20.x/22.x/23.x/24.x</td><td>ARM / x86_64 / riscv64</td></tr><tr><td>Debian</td><td>10 / 11 / 12</td><td>ARM / x86_64 / i386</td></tr></tbody></table>

{% endtab %}

{% tab title="INSTALACIÓN" %}

#### INSTALACIÓN AUTOMATICA (RECOMENDADA)

```bash
curl -sSL https://install.pi-hole.net | bash
```

#### ALTERNATIVA 1: CLONAR REPOSITORIO

```bash
git clone --depth 1 https://github.com/pi-hole/pi-hole.git Pi-hole
cd "Pi-hole/automated install/"
sudo bash basic-install.sh
```

#### ALTERNATIVA 2: DESCARGA MANUAL&#x20;

```bash
wget -O basic-install.sh https://install.pi-hole.net
sudo bash basic-install.sh
```

#### [ALTERNATIVA 3: DOCKER](https://github.com/pi-hole/docker-pi-hole)

{% endtab %}
{% endtabs %}

***

&#x20;                                                                 [***DOCUMENTACIÓN OFICIAL***](https://docs.pi-hole.net)

## INTERFAZ, CONFIGURACIÓN

<figure><img src="https://2982264145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MamKyPczuN7KvAeItev%2Fuploads%2FLlKHAK5xmhlgIofEvgQB%2Fimage.png?alt=media&amp;token=85677fd8-4d00-4a0c-b949-20bc64cc7d10" alt=""><figcaption><p>DASHBOARD</p></figcaption></figure>

<figure><img src="https://2982264145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MamKyPczuN7KvAeItev%2Fuploads%2FoDi2uVtkICexWXGRA1zZ%2Fimage.png?alt=media&amp;token=44a93a02-7356-4aa5-b1c4-bfbc1c11fae2" alt=""><figcaption><p>ADLIST</p></figcaption></figure>

En la sección **Adlists** podremos añadir diferentes listas de bloqueos. (Se podrán encontrar en Internet dichas listas)

Añadiremos la url de la lista de bloqueos, junto a un comentario si queremos.

Veremos la url agregada, donde podremos habilitarlo o deshabilitarlo, ver el comentario e incluso agregar grupos específicos para los clientes conectados.&#x20;

> Para que la lista se actualice, deberemos actualizar el listado en el apartado Tools

<figure><img src="https://2982264145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MamKyPczuN7KvAeItev%2Fuploads%2F9ZPhlXmSVEBDGc7e0gRa%2Fimage.png?alt=media&amp;token=fbdca7e5-b58a-4ebc-8887-43b2d9e0913b" alt=""><figcaption><p>ACTUALIZAR LISTAS DE BLOQUEOS</p></figcaption></figure>

En el apartado de **Tools** -> **Update Gravity**, podremos actualizar las nuevas listas implementadas en el apartado de Adlist, a partir de aqui empezara a funcionar la nueva lista añadida.

<figure><img src="https://2982264145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MamKyPczuN7KvAeItev%2Fuploads%2Fk4F17mlriYqvE49MLBOV%2Fimage.png?alt=media&amp;token=82760bef-6eea-41f5-8bfb-bbc18df9885a" alt=""><figcaption><p>DNS</p></figcaption></figure>

En Settings tendremos diferentes configuraciones e información del sistema.

Nos iremos a DNS para configurar el UpStream DNS Server para tener salida a Internet.

Yo tengo seleccionado del apartado IPv4, los DNS de Google y Cloudflare. (Elegir el que mas os guste)

Una vez configurado los Upstream DNS Server, las listas de bloqueo, tocara implementarlo en la red o manualmente en cada equipo que lo necesite.