# 🍓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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alerodriguezm99.gitbook.io/bariho/proyectos/home-lab/pi-hole.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.