{"id":60,"date":"2022-04-06T13:59:45","date_gmt":"2022-04-06T12:59:45","guid":{"rendered":"https:\/\/steambot.ch\/blog\/?p=60"},"modified":"2022-04-09T14:18:43","modified_gmt":"2022-04-09T13:18:43","slug":"install-pi-hole-using-docker","status":"publish","type":"post","link":"https:\/\/steambot.ch\/blog\/?p=60","title":{"rendered":"Deploying applications on docker"},"content":{"rendered":"\n

Docker<\/a> is a very useful tool to easily deploy applications without having to worry about your server configuration, libraries, etc. Many softwares nowadays are packaged in the form of a docker image and lots are supported by the arm architecture of raspberry pis.<\/p>\n\n\n\n

Linuxserver.io<\/h2>\n\n\n\n

Linuxserver.io<\/a> provided a large and very well maintained catalogue of docker images and configurations you can very easily deploy on many architectures. Have a look at their website<\/a> and pick and choose the applications that better suit your needs.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Reverse proxy<\/h2>\n\n\n\n

Managing many applications, opening ports and configuring networks might get complex pretty fast. That’s why you might want to use a reverse proxy to have an easy web access to all of your docker services. In addition to simplified access through customizable URLs, reverse proxies allow you to encrypt all of your web communications by redirecting your docker services through https. Have a look for instance at treafik reverse proxy<\/a> and follow their instructions for installation and deployment.<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Pi-Hole<\/h2>\n\n\n\n

Deploying Pi-Hole on docker may not be as simple as running the container provided on dockerhub<\/a>. Here is a working install that will allow you to easily deploy pihole in a few steps.<\/p>\n\n\n\n

Note that I assume here that you have a working docker and docker-compose<\/a> install and that you already run a traefik reverse proxy<\/a>. You will easily find details online on how to install and set this up.<\/p>\n\n\n\n

Now let’s go back at our pihole installation: First, create a Dockerfile<\/code> for your dhcp-helper service as follows<\/p>\n\n\n\n

vim Dockerfile<\/code><\/pre>\n\n\n\n
and insert the following instructions inside<\/p>\n\n\n\n
FROM alpine:3.12\nRUN apk --no-cache add dhcp-helper\nEXPOSE 67 67\/udp\nENTRYPOINT [\"dhcp-helper\", \"-n\"]<\/code><\/pre>\n\n\n\n
Now you just need to create the docker-compose yaml file<\/p>\n\n\n\n
vim docker-compose.yml<\/code><\/pre>\n\n\n\n
with the following configuration<\/p>\n\n\n\n
version: \"3\"\n\n\nservices:\n  pihole:\n    container_name: pihole\n    image: pihole\/pihole:latest\n    ports:\n      - \"53:53\/tcp\"\n      - \"53:53\/udp\"\n    environment:\n      TZ: 'Europe\/London'\n      WEBPASSWORD: '<My_PASSWORD>' # set a secure password here or it will be random\n      DNSMASQ_LISTENING: 'all'\n      ServerIP: '192.168.1.XX'\n      DNS1: '9.9.9.9' # Or your favorite DNS server 1\n      DNS2: '149.112.112.112'\n # Or your favorite DNS server 2\n      VIRTUAL_HOST: '<Machine_hostname>'\n    # Volumes store your data between container upgrades\n    volumes:\n       - '.\/etc-pihole\/:\/etc\/pihole\/'\n       - '.\/etc-dnsmasq.d\/:\/etc\/dnsmasq.d\/'\n    dns:\n      - 127.0.0.1\n      - 1.1.1.1\n    # Recommended but not required (DHCP needs NET_ADMIN)\n    #   see https:\/\/github.com\/pi-hole\/docker-pi-hole#note-on-capabilities\n    cap_add:\n      - NET_ADMIN\n    restart: unless-stopped\n    depends_on:\n      - dhcphelper\n    labels:\n      - \"traefik.enable=true\"\n      - \"traefik.http.routers.pihole.rule=Host(`pihole.mydomain.com`)\"\n      - \"traefik.docker.network=proxy\"\n      - \"traefik.http.services.pihole.loadbalancer.server.port=80\"\n      - \"traefik.http.routers.pihole.tls=true\"\n      - \"traefik.http.routers.pihole.entrypoints=websecure\"\n    networks:\n      proxy:\n        ipv4_address: '172.18.0.45'\n      backend:\n        ipv4_address: '172.31.0.100'\n\n  dhcphelper:\n    build: .\/\n    restart: unless-stopped\n    network_mode: \"host\"\n    command: -s 172.31.0.100\n    cap_add:\n      - NET_ADMIN\n\nnetworks:\n  backend:\n    ipam:\n      config:\n        - subnet: 172.31.0.0\/16\n    driver_opts:\n      com.docker.network.bridge.name: br_pihole\n  proxy:\n    external: true\n<\/code><\/pre>\n\n\n\n
And just start the container with<\/p>\n\n\n\n
docker-compose up -d<\/code><\/pre>\n\n\n\n
that’s it, pihole is running on your machine.<\/p>\n\n\n\n
Other docker images worth considering<\/h2>\n\n\n\n
Below are some other great applications, unfortunately not provided by Linexserver.io as of today, but that you might want to check out:<\/p>\n\n\n\n