Overview: Support for Blocky

Application Name: Blocky
Application:  https://github.com/0xERR0R/blocky

Documentation: https://0xERR0R.github.io/blocky/

 

Blocky is a DNS proxy and ad-blocker for the local network written in Go

 

Make sure to look at the complete documentation

 

Please post any questions/issues relating to this template  in this thread.

doesn't work and the ports are defined as variables not ports

 

//edit

if I create a new container without your template and use these arguments the container works

--restart=unless-stopped --hostname blocky1 -p 4000:4000/ -p 53:53/udp -p 53:53/tcp -v /mnt/user/appdata/blocky/config/config.yml:/app/config.yml -v /etc/localtime:/etc/localtime -e TZ=Europe/Berlin

 

Edited May 1, 20233 yr by chiwou

40 minutes ago, chiwou said:

doesn't work and the ports are defined as variables not ports

 

//edit

if I create a new container without your template and use these arguments the container works

--restart=unless-stopped --hostname blocky1 -p 4000:4000/ -p 53:53/udp -p 53:53/tcp -v /mnt/user/appdata/blocky/config/config.yml:/app/config.yml -v /etc/localtime:/etc/localtime -e TZ=Europe/Berlin

 

thanks for letting me know 

but i dont have this issue :

What kind of error are you getting ?

Edited May 1, 20233 yr by ZappyZap

never mind, today the container starts normal, but could you make it so that the port mappings are shown in the overview?

2 hours ago, chiwou said:

never mind, today the container starts normal, but could you make it so that the port mappings are shown in the overview?

what do you mean ?

Hi, I'm trying to spin this container, but no matter where I put the config.yml (or yaml, tried that too), container cannot find it? 

 

Error: unable to load configuration: can't read config file(s): stat /mnt/user/blocky/config.yml: no such file or directory

 

Can you give me some advice what is the correct approach to this damn config? 

@marcinwhite
you have 2 parameters :

• Config File location: is the Location of the config file in the container
  ==> Leave it as it (/app/config/config.yml)
• Config Dir: is the location on your host and will be map to ontainer Path: /app/config
  ==> usually : /mnt/user/appdata/blocky/config

Let me know 

Edited October 15, 20241 yr by ZappyZap

All good, thanks, I was messing with /app/config location unnecessary.

27 minutes ago, marcinwhite said:

All good, thanks, I was messing with /app/config location unnecessary.

glad all sort out 

Hello,

I'm using your blocky template and it works fine.

Recently I noticed that Unraid always displays docker health "unhealthy" for the blocky container (see screenshot attached).

In the logs of the blocky container I see no issues, does someone have an idea how to fix?

 

i will check if the image have a health check 
and what is it 

what is in the log ?

Found the issue reason for the unhealthy state:

https://github.com/0xERR0R/blocky/issues/1666

 

Since I binded port 53 to a specific IP in my config.yml, above issue is occuring.

The image by itself is doing health checks.

 

My solution was to disable the health check in Unraid container settings:

- Edit the blocky docker container in Unraid

- Add "--no-healthcheck" under Extra Parameters

- Save and restart the container

 

Thanks for building this Unraid template.

The developer of blocky did an awesome job, DNS requests in my network are instant now and faster than before when I was using Pihole and Adguard Home.

Yeah i was reading this issue as well.
Thanks for the update

Hello, I'm having an issue with the blocky template where adding the http 4000 port to both the config, or the docker itself doesn't actually expose the media port/endpoint for Prometheus... I'm not sure what I'm doing wrong.

My config:

upstreams:

groups:

default:

- "https://185.95.218.42/dns-query#dns.digitale-gesellschaft.ch"

- "https://80.241.218.68/dns-query#fdns1.dismail.de"

- "https://46.182.19.48/dns-query#dns2.digitalcourage.de"

strategy: parallel_best

---

blocking:

denylists:

hagezi-pro:

- https://raw.githubusercontent.com/hagezi/dns-blocklists/main/hosts/pro.txt

allowlists:

common_exceptions:

- https://raw.githubusercontent.com/hagezi/dns-blocklists/main/adblock/whitelist-referral-native.txt

clientGroupsBlock:

default:

- hagezi-pro

- common_exceptions

- personal_exceptions

---

caching:

minTime: 5m

maxTime: 30m

---

log:

level: error

---

prometheus:

enable: true

path: /metrics

---

ports:

dns: 53

http: 4000

Edited September 3, 2025Sep 3 by tittimous

post your question in the Blocky git hub, as this is not issue with template
let me know if you need further help