selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Numa logo

Self-host Numa

v0.25.0

Portable DNS resolver with ad blocking and .numa domains

ReleaseOpen SourceMIT
Updated10 hours ago
LanguageRust
Setup difficultyModerate
Stars
1 952
Ports
53 (DNS (UDP/TCP)), 5380 (HTTP dashboard/API), 853 (DNS-over-TLS listener), 80 (HTTP proxy for .numa services), 443 (HTTPS proxy for .numa services), 8765 (Mobile API)
Docker
ghcr.io/razvandimescu/numa
Install with Docker
Numa dashboard demo showing the web UI

What is Numa?

Numa is a portable DNS resolver written in Rust that runs as a single ~8MB binary on macOS, Linux, and Windows. It caches DNS queries, blocks ads and trackers using Hagezi Pro lists, and offers three resolution modes: forward (proxy to existing DNS), recursive (resolve from root servers with full DNSSEC), and auto (probe roots, fall back to DoH). It creates local .numa domains for dev services with automatic HTTPS and WebSocket support, enables LAN service discovery via mDNS, and provides a REST API for DNS overrides. Numa includes a DNS-over-TLS listener (RFC 7858) for encrypted clients like iOS Private DNS, an Oblivious DoH client and relay (RFC 9230), and a web dashboard. Install via Docker, Homebrew, cargo, install script, or native packages (Arch, Nix). Runs as a system service and can configure system DNS automatically.

Should you self-host Numa?

Numa scores 57/100 on selfhost.directory (how scoring works) and ranks #16 of 41 in DNS. It has 1 952 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.25.0, came out on 23 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is AdGuard Home (84/100, 37 798 stars). It scores higher overall, so compare the two before you pick. See Numa vs AdGuard Home side by side.

Features

  • Ad and tracker blocking
  • Conditional forwarding
  • Developer DNS overrides
  • DNS Caching
  • DNS-over-HTTPS upstream
  • DNS-over-TLS listener
  • DNSSEC Validation
  • LAN service discovery
  • Local .numa service domains
  • Mobile onboarding
  • Oblivious DoH (ODoH)
  • Recursive DNS resolution
  • Request hedging
  • REST API
  • Web Dashboard

Numa README

How to install Numa

Install Numa with Docker

docker run -d --name numa --network host -v numa-data:/var/lib/numa ghcr.io/razvandimescu/numa

Port mapping (macOS/Windows Docker Desktop)

docker run -d --name numa -p 53:53/udp -p 53:53/tcp -p 5380:5380 -v numa-data:/var/lib/numa ghcr.io/razvandimescu/numa

Multi-arch: linux/amd64 and linux/arm64. Host networking recommended on Linux.

Numa releases & version history

More in Network

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…