> 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="/files/daGE6Rt7gatOiV1eGogi" alt=""><figcaption><p>DASHBOARD</p></figcaption></figure>

<figure><img src="/files/gWUR424eD3syqbzQGKH8" 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="/files/9uziEUFDtOaGdbjGd3lF" 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="/files/ggsWOeFCBlMsC4wydwz1" 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.