ErrLookup › AdguardTeam/AdGuardHome

AdguardTeam/AdGuardHome

Network-wide ads & trackers blocking DNS server · TypeScript · 1,021 source files

Analyzed at b41aefbe51 on 2026-08-27. 226 documented errors.

Code / Message	Type	Severity	Tags
duplicated values: %v	validation	error	config, refresh, service-manager, go
unmarshalling json data into aghalg.NullBool: bad value %q	validation	error	service-restart, refresh, port-binding, go
json duration is nil	validation	error	config, config-manager, refresh, go
parsing json time: %w	validation	warning	http, json, dns, request-validation, go
json time is nil	validation	error	dns, config-update, http, validation, go
interface %s has no ipv4 addresses	error_code	warning	http, json, request-validation, go
interface %s has no ipv6 addresses	error_code	warning	querylog, search, http, validation, go
invalid ip version %d	validation	warning	querylog, search, http, validation, go
could not find hardware port for %s	error_code	warning	querylog, search, filtering, validation, go
networksetup failed to set dns servers: %w	error_code	error	querylog, config, validation, go
networksetup failed to configure dns servers: %w	error_code	error	querylog, file-rotation, filesystem, permissions, go
parsing etc/resolv.conf file: %w	exception	error	querylog, search, file-io, go
found no dns servers in %s	exception	error	schedule, json, validation, config, go
writing conf: %w	exception	error	schedule, yaml, validation, config, go
invalid pattern %q: %w	exception	error	schedule, validation, time, config, go
creating watcher: %w	exception	error	schedule, validation, time, config, go
checking file %q: %w	exception	error	schedule, validation, time, config, go
adding %q: %w	exception	error	schedule, validation, time, config, go
removing %q: %w	exception	error	schedule, validation, time, config, go
%s: not supported on %s: %w	exception	warning	platform-unsupported, go, os, syscall, errors-errunsupported
no %s instances found	exception	error	process, pid, ps, reload, not-found
ps finished with code %d	exception	error	process, ps, exit-code, subprocess
executing the command: %w	exception	error	process, ps, exec, context-canceled
scanning stdout: %w	exception	error	ps, bufio-scanner, too-long-line, process
getting executable path: %v	exception	error	macos, os-executable, service-start, darwin
evaluating executable symlinks: %v	exception	error	macos, symlink, evalsymlinks, service-start
looking up group: %w	exception	error	unix, group, lookup, setgid, os-user
parsing gid: %w	exception	error	unix, gid, strconv, parse-error, os-user
setting gid: %w	exception	error	unix, setgid, eperm, privileges, syscall
looking up user: %w	exception	error	unix, user, lookup, setuid, os-user
parsing uid: %w	exception	error	unix, uid, strconv, parse-error, os-user
setting uid: %w	exception	error	unix, setuid, eperm, privileges, syscall
closing: %w	exception	error	windows, file-close, sharing-violation, atomic-write
renaming: %w	exception	error	windows, rename, file-locked, atomic-write
opening pending file: %w	exception	error	windows, create-temp, permission, disk-full
preparing pending file: %w	exception	error	windows, chmod, file-attributes, transient-lock
unknown cipher %q	exception	error	tls, cipher-suites, config-validation, crypto
parsing tls certificate: %w	exception	critical	tls, x509, certificate, pem, config
unwatching %s %s: %w	exception	warning	fsnotify, file-watching, cert-rotation, tls
watching %s %s: %w	exception	warning	tls, fsnotify, filesystem, watcher, inotify
refreshing: %w	exception	info	tls, context, refresh, cancellation
starting watcher: %w	exception	error	tls, fsnotify, startup, inotify
shutting down watcher: %w	exception	warning	tls, fsnotify, shutdown, lifecycle
loading tls certificate: %w	exception	critical	tls, x509, pem, certificate, crypto
reading cert file: %w	exception	critical	tls, filesystem, configuration, startup
reading key file: %w	exception	critical	tls, filesystem, permissions, configuration
certificate does not verify: %w	validation	error	tls, x509, certificate, verification, chain
parsing certificate at index %d: %w	validation	error	tls, x509, pem, parsing, certificate
parsing private key: %w	validation	error	tls, crypto, private-key, parsing
certificate-key pair: %w	validation	critical	tls, x509, crypto, key-mismatch
tls: found unknown private key type %T in PKCS#8 wrapping	validation	error	tls, crypto, private-key, pkcs8, algorithm
userid: %w	validation	error	user, validation, database, in-memory-db
login: %w	validation	error	user, database, duplicate, login, uniqueness
loading sessions: %w	error_code	error	sessions, bbolt, storage, startup, database
starting transaction: %w	error_code	error	bbolt, database, locking, transaction, startup
processing sessions: %w	error_code	error	sessions, bbolt, deserialization, schema, startup
committing transaction: %w	error_code	error	bbolt, database, commit, disk-full, io
iterating over sessions: %w	error_code	error	sessions, bbolt, iteration, deserialization
deleting sessions: %w	error_code	error	bbolt, storage, sessions, startup
length of the data is less than expected: got %d	error_code	error	bbolt, serialization, corruption, sessions
login: expected length %d, got %d	error_code	error	bbolt, serialization, validation, sessions
storing session: %w	error_code	error	bbolt, sessions, login, storage
creating bucket: %w	error_code	error	bbolt, bucket, transaction
putting data: %w	error_code	error	bbolt, put, sessions
expired session: %w	error_code	warning	bbolt, session-expiry, delete
another client %q uses the same ClientID %q	validation	error	client, duplicate, clientid, validation
another client %q uses the same IP %q	validation	error	client, ip, duplicate, validation
another client %q uses the same subnet %q	validation	error	client, subnet, duplicate, validation
another client %q uses the same MAC %q	validation	error	client, mac, duplicate, validation
invalid upstream servers: %w	validation	error	client, upstream, dns, validation, config
invalid tag: %q	validation	error	client, tags, validation
adding client %q at index %d: %w	validation	critical	storage, constructor, startup, config
client %q is not found	error_code	error	storage, client, not-found, update
parsing config file for upgrade: %w	error_code	error	config, yaml, migration, parse
generating new config: %w	error_code	error	config, yaml, migration, serialization
unknown current schema version %d	validation	error	config, migration, version, schema
unknown target schema version %d	validation	error	config, migration, version, schema
target schema version %d lower than current %d	validation	error	config, migration, version, downgrade
migrating schema %d to %d: %w	error_code	error	config, migration, schema, step-failed
unexpected type of upstream field: %T	validation	error	config, migration, upstream, yaml, type-mismatch
persistent client at index %d: unexpected type %T	validation	error	config, migration, client, yaml, type-mismatch
persistent client at index %d: %w	error_code	error	config, migration, client, whois, type-mismatch
invalid bind_host value: %s	validation	error	config, migration, bind, network, validation
filters: at index %d: expected object, got %T	validation	error	config, migration, filters, yaml, type-mismatch
generating password hash: %w	error_code	error	config, migration, auth, bcrypt, password
unexpected type of client at index %d: %T	validation	error	config, migration, yaml, type-assertion
client at index %d: %w	error_code	error	config, migration, field-type
unexpected type of %q: %T	validation	error	config, migration, yaml, type-mismatch
%v is not an IPv4 %s	validation	error	dhcp, ipv4, validation, config
gateway ip %v in the ip range: %v-%v	validation	error	dhcp, gateway, ip-range, validation
range start %v is outside network %v	validation	error	dhcp, subnet, range, validation
range end %v is outside network %v	validation	error	dhcp, subnet, range, validation
parsing hardware address: %w	error_code	error	dhcp, leases, mac-address, persistence
parsing expiry time: %w	error_code	error	dhcp, leases, time-parsing, persistence
reading db: %w	error_code	error	dhcp, leases, filesystem, permissions
decoding db: %w	exception	error	dhcp, leases, json, persistence
resetting dhcpv4 leases: %w	exception	error	dhcp, leases, ipv4, reset
resetting dhcpv6 leases: %w	exception	error	dhcp, leases, ipv6, reset
neither dhcpv4 nor dhcpv6 srv is configured	validation	error	dhcp, config, validation
loading db: %w	exception	critical	dhcp, startup, leases, persistence
creating dhcpv4 srv: %w	exception	error	dhcp, ipv4, startup, validation
creating dhcpv6 srv: %w	exception	error	dhcp, ipv6, startup, validation
couldn't parse MAC address: %w	validation	error	dhcp, static-lease, mac-address, api
checking static ip: %w	http	error	dhcp, network, static-ip, http-500
setting static ip: %w	http	error	dhcp, network, static-ip, permissions, http-500
starting dhcp server: %w	http	error	dhcp, network, socket-bind, adguard-home, configuration
bad dhcpv4 configuration: %w	validation	error	dhcp, dhcpv4, validation, configuration, adguard-home
bad dhcpv6 configuration: %w	validation	error	dhcp, dhcpv6, validation, configuration, ipv6
dhcpv4 or dhcpv6 configuration must be complete	validation	error	dhcp, validation, configuration, adguard-home
failed to get addresses for interface %s: %w	http	warning	dhcp, network, interface-enumeration, race-condition, linux
decoding json: %w	validation	error	dhcp, json, validation, api, static-lease
parsing: %w	validation	error	dhcp, validation, mac-address, static-lease
start is greater than or equal to end	validation	error	dhcp, validation, ip-range, configuration
range is too large	validation	error	dhcp, validation, ip-range, configuration
decoding old db: %w	exception	error	dhcp, migration, json, database, adguard-home
decoding hex: %w	validation	error	dhcp, options, hex, validation, configuration
parsing ip at index %d: %w	validation	error	dhcp, options, ipv4, validation, configuration
decoding dur: %w	validation	error	dhcp, options, duration, validation, configuration
decoding u%d: %w	validation	error	dhcp, options, validation, configuration, integer-range
decoding bool: %w	validation	error	dhcp, options, boolean, validation, configuration
unknown option type %q	validation	error	dhcp, options, validation, configuration, enum
parsing option code: %w	validation	error	dhcp, options, validation, configuration, dhcp-option-code
converting source link-layer address: %w	exception	error	dhcp, ipv6, router-advertisement, icmpv6, network-interface
creating packet: %w	exception	error	dhcp, ipv6, router-advertisement, configuration, startup
dhcpv6 ra: icmp.ListenPacket: %w	exception	error	dhcp, ipv6, icmpv6, socket-bind, permissions, router-advertisement
dhcpv6 ra: SetHopLimit: %w	exception	error	dhcpv6, router-advertisement, ipv6, socket-options, network
dhcpv6 ra: SetMulticastHopLimit: %w	exception	error	dhcpv6, router-advertisement, multicast, ipv6, socket-options
no valid parts	validation	warning	dhcp, hostname, validation, client-input
subnet %s does not contain the ip %q	validation	error	dhcp, static-lease, subnet, validation, ipv4
lease %s (%s) out of range, not adding	validation	error	dhcp, dynamic-lease, ip-range, validation, ipv4
hostname: %w	validation	error	dhcp, hostname, duplicate, conflict, lease
auth: blocked for %s	http	warning	auth, rate-limit, http, login
auth: parsing remote address: %w	http	error	auth, network, ip-parsing, http
searching session by token: %w	http	error	auth, session, storage, middleware
searching user by login %q: %w	http	error	auth, user-store, storage, middleware
decoding value: %w	http	warning	auth, cookie, hex-decode, session
getting remote address: %w	http	error	auth, basic-auth, network, ip-parsing
login attempt blocked for %s	http	warning	auth, basic-auth, rate-limit
invalid blocked services: %w	validation	error	clients, blocked-services, validation, api
creating safesearch for client %q: %w	http	error	clients, safe-search, validation, api
validating blocked services: %w	validation	error	blocked-services, validation, schedule
dns.bind_hosts at index %d is not a valid ip address	validation	critical	config, dns, yaml, validation, startup
writing new config: %w	error_code	critical	config, filesystem, permissions, startup, upgrade
validating tcp ports: %w	validation	critical	config, ports, tls, validation, startup
validating udp ports: %w	validation	critical	config, ports, quic, udp, validation, startup
generating config file: %w	error_code	error	config, yaml, serialization
writing config file: %w	error_code	critical	config, filesystem, permissions, persistence
override_tls_ciphers: %w	validation	error	config, tls, ciphers, validation
cannot get network interfaces: %w	error_code	error	dns, network, interfaces, status-api
collecting dns addresses: %w	error_code	error	dns, status-api, network
os.MkdirAll: %s: %w	error_code	error	install, systemd, resolved, permissions, filesystem
init querylog: %w	error_code	error	dns, adguard-home, querylog, startup, configuration
creating dns server: %w	error_code	critical	dns, adguard-home, server-startup, port-binding, network
creating new dns server: %w	error_code	critical	dns, adguard-home, server-startup, reconfiguration
creating new dns server config: %w	error_code	error	dns, adguard-home, upstream-config, configuration, tls
preparing dns server: %w	error_code	error	dns, adguard-home, upstream-connectivity, prepare, server-startup
constructing tls config: %w	error_code	error	dns, adguard-home, tls, certificates, configuration
dnscrypt_config_file: %w	validation	error	dns, adguard-home, dnscrypt, missing-config, configuration
opening dnscrypt config: %w	error_code	error	dns, adguard-home, dnscrypt, file-io, permissions
decoding dnscrypt config: %w	validation	error	dns, adguard-home, dnscrypt, yaml, parsing
creating dnscrypt cert: %w	error_code	error	dns, adguard-home, dnscrypt, cryptography, key-mismatch
getting embedded client subdir: %w	exception	critical	go, embedded-assets, frontend, startup, fs-sub
starting tls manager: %w	exception	critical	go, tls, certificates, acme, startup
initializing auth module: %w	exception	critical	go, auth, config, users, bcrypt
unknown language: %q	validation	warning	go, i18n, validation, http-api, config
cannot initialize syslog: %w	exception	error	go, logging, syslog, containers, configuration
bad dns protocol %q	validation	warning	go, apple, mobileconfig, dns-protocol, http-api
parsing port: %w	validation	error	go, cli, argument-parsing, port, validation
parsing arg at index %d: %w	validation	error	go, cli, argument-parsing, usage
unknown option %s	validation	error	go, cli, argument-parsing, unknown-flag
applying option %s: %w	validation	error	go, cli, argument-parsing, flag-conflict
got %s without argument	validation	error	go, cli, argument-parsing, missing-value
invalid theme %q, supported: %q, %q, %q	validation	warning	go, http-api, profile, theme, validation, json
getting current directory: %w	exception	error	go, filesystem, service, cwd, os-getwd
initializing service: %w	exception	error	go, service, systemd, service-integration
initializing service manager: %w	exception	error	go, service, restart, update, service-manager
restarting service: %w	exception	error	go, service, restart, privileges, systemd
action %q: %w	exception	error	go, service, cli, systemd, privileges
%w: %q	validation	error	go, cli, service, enum-validation
service manager can't reload: %w	exception	error	service-management, unsupported-operation, type-assertion
reloading service: %w	exception	error	service-management, reload, privileges
installing service: %w	exception	critical	service-management, install, privileges
starting service: %w	exception	critical	service-management, start, install
dialing v4: %w	exception	error	ipset, netfilter, linux, permissions
dialing v6: %w	exception	error	ipset, netfilter, ipv6, linux
invalid value %q: expected one slash	validation	error	ipset, config, validation
invalid value %q: empty ipset name	validation	error	ipset, config, validation
config line at idx %d: %w	validation	error	ipset, config, wrapping
getting ipsets from config line at idx %d: %w	exception	error	ipset, config, lookup
unexpected ipset family %q	exception	error	ipset, netlink, kernel, validation
unknown ipset %q	validation	error	ipset, lookup, config
%q %q making header query: %w	exception	error	ipset, netlink, concurrency
dialing netfilter: %w	exception	error	ipset, netfilter, initialization
getting ipsets: %w	exception	error	ipset, config, initialization
unexpected family %s for ipset %q	exception	error	ipset, internal-invariant, netfilter
adding %q%s to %q %q: %w	exception	error	ipset, netlink, runtime
%q %q unexpected family %q	exception	error	ipset, internal-invariant, netfilter
creating config manager: %w	exception	critical	startup, config, initialization
starting web: %w	exception	error	web, startup, network, bind
starting dnssvc: %w	exception	error	dns, startup, network, bind
shutting down web: %w	exception	warning	web, shutdown, timeout
shutting down dnssvc: %w	exception	warning	dns, shutdown, timeout
shutdown failed: %w	exception	error	refresh, shutdown, reconfiguration
start %s is greater or equal to %s	validation	error	schedule, config-validation, time-range
end %s is greater than %s	validation	error	schedule, config-validation, time-range
%s: parsing interval: %s	validation	error	http, query-param, parsing, stats
%s: must be a multiple of 1 hour	validation	error	http, query-param, validation, stats
unsupported interval: %w	validation	error	stats, config-validation, interval
opening database: %w	exception	error	stats, database, bbolt, filesystem
opening a transaction: %w	exception	error	stats, database, bbolt, locking
panic: %w	exception	error	stats, panic, recovery
panic: recovered value of type %[1]T: %[1]v	exception	error	stats, panic, recovery
opening transaction: %w	exception	error	stats, database, bbolt, shutdown
closing database: %w	exception	error	stats, database, bbolt, reset
unknown result code %d	validation	error	stats, validation, enum
creating bucket: %w	exception	error	stats, database, bbolt
encoding unit: %w	exception	error	stats, serialization, gob
putting unit to database: %w	exception	error	stats, database, bbolt
constructing request to %s: %w	exception	error	updater, http, url, config
sending http request to %s: %w	exception	warning	updater, http, network
got status code %d, want %d	http	warning	updater, http, status-code
reading response from %s: %w	exception	warning	updater, http, network
version.json: %w	exception	error	updater, json, parsing
bad value for %q key: %w	validation	error	update-check, json-validation, updater
version.json: bad key %q: %w	validation	error	update-check, platform-support, metadata
preparing: %w	exception	error	self-update, filesystem, updater