# looterz/grimd

:zap: fast dns proxy that can run anywhere, built to black-hole internet advertisements and malware servers

Repository: https://github.com/looterz/grimd
Canonical: https://ross.abutalabs.com/products/grimd
Language: Go
License: MIT
License Family: permissive
Last push: 2024-03-13T22:33:39+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3789, "days_push": 903, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1416, forks 108 (observed 2026-08-28T04:04:39.855745+00:00)

## What it is
Grimd is a fast DNS proxy server written in Go that blackholes advertisement and malware domains using configurable blocklists. It runs anywhere via a single binary or Docker and includes a web dashboard and HTTP API for management.

## Use cases
- block ads at the network dns level
- self-hosted pihole alternative
- block malware domains for my whole network
- run a fast dns proxy server
- filter dns queries with custom blocklists
- set up dns sinkhole in docker

## When to choose
- you want a lightweight, fast dns-level ad blocker you can run anywhere including docker
- you need programmatic control of blocklists via an http api and web dashboard
- you prefer a single go binary over heavier solutions like pi-hole

## When to avoid
- you need dns-level features like dhcp, per-client rules, or deep query analytics that pi-hole or adguard home offer
- you want a maintained project with frequent updates - the latest release is from early 2024
- you need dns-over-https/tls upstream encryption support

## Facets
- artifact type: application
- maturity: maintenance
- function: proxy, security, http-server, web-scraping, self-hosted
- domain: networking, security, privacy, self-hosted
- platform: windows, self-hosted, go, cross-platform
- tags: dns-proxy, ad-blocking, dns-sinkhole, blocklists, pi-hole-alternative, malware-blocking, linux, macos, docker

## Member repositories
- looterz/grimd (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:39.855745+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:38:06.087888+00:00, confidence not recorded.
  - readme: https://github.com/looterz/grimd (fetched 2026-08-28T04:04:39.855745+00:00, sha 864ed7d239b4)
- Data as of 2026-08-30T08:39:29.467469+00:00.