# Instalar Pihole

La instalación de Pihole es muy sencilla, y no requiere de grandes requisitos para funcionar, ya que en si, el software es muy liviano.

Se puede instalar en casi cualquier cosa desde un servidor virtual mínimo, una Raspberry Pi o junto con otra instancia de cualquier cosa que no tenga configurado un listener en el puerto 53 (DNS)

### Requisitos

Mín. 2 GB de espacio libre, se recomiendan 4 GB  
512 MB de RAM

Como podemos ver, "cabe" en casi cualquier cosa que montemos.

A pesar del nombre, no está limitado a ejecutar Pi-hole en una Raspberry Pi. Cualquier hardware que ejecute uno de los sistemas operativos compatibles servirá. Pi-hole es compatible con distribuciones que utilizan systemd o sysvinit

Sistemas operativos compatibles

<table id="bkmrk-distribuci%C3%B3n-versi%C3%B3n"><thead><tr><th>Distribución</th><th>Versión</th><th>Arquitectura</th></tr></thead><tbody><tr><td>Raspberry Pi <abbr title="Operating system">OS</abbr>   
(formerly Raspbian)</td><td>Buster / Bullseye</td><td>ARM</td></tr><tr><td>Armbian <abbr title="Operating system">OS</abbr></td><td>Cualquiera</td><td>ARM / x86\_64 / riscv64</td></tr><tr><td>Ubuntu</td><td>20.x / 22.x / 23.x</td><td>ARM / x86\_64</td></tr><tr><td>Debian</td><td>10 / 11 / 12</td><td>ARM / x86\_64 / i386</td></tr><tr><td>Fedora</td><td>36 / 37 / 38</td><td>ARM / x86\_64</td></tr><tr><td>CentOS Stream</td><td>8 / 9</td><td>x86\_64</td></tr></tbody></table>

#### Direccionamiento IP

Pi-hole necesita una dirección IP estática para funcionar correctamente (valdría también con una reserva DHCP).

#### Puertos

<table id="bkmrk-servicio-puerto-prot" style="width: 100%;"><thead><tr><th style="width: 12.235356%;">Servicio</th><th style="text-align: left; width: 14.582495%;">Puerto</th><th style="text-align: left; width: 17.921533%;">Protocolo</th><th style="width: 55.368078%;">Notas</th></tr></thead><tbody><tr><td style="width: 12.235356%;">pihole-<abbr title="Pi-hole's Faster Than Light daemon">FTL</abbr></td><td style="text-align: left; width: 14.582495%;">53 (<abbr title="Domain Name Service (decentralized naming system for computers, services, or other resources connected to the Internet)">DNS</abbr>)</td><td style="text-align: left; width: 17.921533%;"><abbr title="Transmission Control Protocol (protocol providing reliable, ordered, and error-checked delivery of data between applications running on hosts communicating via an IP network)">TCP</abbr>/<abbr title="User Datagram Protocol (a network communications method for sending messages as datagrams)">UDP</abbr></td><td style="width: 55.368078%;">Si tienes otro servidor DNS en ejecución, como BIND, deberás desactivarlo para que Pi-hole responda a las consultas de DNS.</td></tr><tr><td style="width: 12.235356%;">pihole-<abbr title="Pi-hole's Faster Than Light daemon">FTL</abbr></td><td style="text-align: left; width: 14.582495%;">67 (<abbr title="Dynamic Host Configuration Protocol (network management protocol for configuring Internet Protocol version 4 (IPv4) hosts with IP addresses)">DHCP</abbr>)</td><td style="text-align: left; width: 17.921533%;"><abbr title="Internet Protocol version 4 (addresses like 192.168.0.1)">IPv4</abbr> <abbr title="User Datagram Protocol (a network communications method for sending messages as datagrams)">UDP</abbr></td><td style="width: 55.368078%;">El servidor DHCP es una característica opcional que requiere puertos adicionales.</td></tr><tr><td style="width: 12.235356%;">pihole-<abbr title="Pi-hole's Faster Than Light daemon">FTL</abbr></td><td style="text-align: left; width: 14.582495%;">547 (<abbr title="Dynamic Host Configuration Protocol version 6 (a network protocol for configuring Internet Protocol version 6 (IPv6) hosts with IP addresses)">DHCPv6</abbr>)</td><td style="text-align: left; width: 17.921533%;"><abbr title="Internet Protocol version 6 (addresses like 2001:db8::ff00:42:8329)">IPv6</abbr> <abbr title="User Datagram Protocol (a network communications method for sending messages as datagrams)">UDP</abbr></td><td style="width: 55.368078%;">El servidor DHCP v6 es una característica opcional que requiere puertos adicionales.</td></tr><tr><td style="width: 12.235356%;">lighttpd</td><td style="text-align: left; width: 14.582495%;">80 (<abbr title="Hypertext Transfer Protocol (HTTP), an application protocol for distributed, collaborative, and hypermedia information systems">HTTP</abbr>)</td><td style="text-align: left; width: 17.921533%;"><abbr title="Transmission Control Protocol (protocol providing reliable, ordered, and error-checked delivery of data between applications running on hosts communicating via an IP network)">TCP</abbr></td><td style="width: 55.368078%;">Si ya tienes otro servidor web ejecutándose, como Apache, el servidor web de Pi-hole no funcionará. Puedes desactivar el otro servidor web o cambiar el puerto en el que escucha lighttpd, lo que le permite mantener ambos servidores web en funcionamiento.</td></tr><tr><td style="width: 12.235356%;">pihole-<abbr title="Pi-hole's Faster Than Light daemon">FTL</abbr></td><td style="text-align: left; width: 14.582495%;">4711</td><td style="text-align: left; width: 17.921533%;"><abbr title="Transmission Control Protocol (protocol providing reliable, ordered, and error-checked delivery of data between applications running on hosts communicating via an IP network)">TCP</abbr></td><td style="width: 55.368078%;"><abbr title="Pi-hole's Faster Than Light daemon"></abbr>FTL es el puerto del motor API y utiliza el puerto 4711 en la interfaz localhost. No se debe poder acceder a este puerto desde ninguna otra interfaz.</td></tr></tbody></table>

Ahora vamos a ver como instalarlo en un servidor del panel de Neodigit o en cualquier máquina con Debian

### Instalación

La instalación es muy sencilla y bastará con ejecutar un simple comando

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

O bien descargar el ejecutable y ejecutarlo

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

También se puede instalar mediante un clon de su repositorio de git

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

##### Instalación en Docker

También se puede instalar en docker, la forma más sencilla con docker copose creando un fichero docker-compose.yml:

```bash
version: "3"

# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/
services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    # For DHCP it is recommended to remove these ports and instead add: network_mode: "host"
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "67:67/udp" # Only required if you are using Pi-hole as your DHCP server
      - "80:80/tcp"
    environment:
      TZ: 'Europe/Madrid'
      WEBPASSWORD: 'TecnocraticaMola' #'set a secure password here or it will be random'
    # Volumes store your data between container upgrades
    volumes:
      - './etc-pihole:/etc/pihole'
      - './etc-dnsmasq.d:/etc/dnsmasq.d'
    #   https://github.com/pi-hole/docker-pi-hole#note-on-capabilities
    cap_add:
      - NET_ADMIN # Required if you are using Pi-hole as your DHCP server, else not needed
    restart: unless-stopped

```

### Configurar equipos

El siguiente paso es configurar como DNS en nuestros equipos de red, para que usen nuestro Pihole cono servidor DNS de nuestra red.