Files
coredns/coredns.1.md
John-Michael Mulesa 1c15569168 feat: add support for running CoreDNS as a Windows service (#7962)
* feat: add support for running CoreDNS as a Windows service

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

* Use non-deprecated service check function.

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

* refactor: remove deprecated build tags and clean up imports in service files

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

* ci: add Windows test workflow and fix log field access in service_windows.go

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

* test: implement cross-platform file permission restriction for Windows compatibility in run_test.go

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

* refactor: remove Windows-specific icacls test logic and restrict unreadable file test to non-Windows platforms

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

* docs: add documentation for -windows-service flag in man page

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>

---------

Signed-off-by: John-Michael Mulesa <jmulesa@gmail.com>
2026-03-26 21:10:53 +02:00

1.5 KiB

CoreDNS

coredns - pluggable DNS nameserver optimized for service discovery and flexibility.

Synopsis

coredns [-conf FILE] [-dns.port PORT} [OPTION]...

Description

CoreDNS is a DNS server that chains plugins. Each plugin handles a DNS feature, like rewriting queries, kubernetes service discovery or just exporting metrics. There are many other plugins, each described on https://coredns.io/plugins and their respective manual pages. Plugins not bundled by default in CoreDNS are listed on https://coredns.io/explugins.

When started without options CoreDNS will look for a file named Corefile in the current directory, if found, it will parse its contents and start up accordingly. If no Corefile is found it will start with the whoami plugin (coredns-whoami(7)) and start listening on port 53 (unless overridden with -dns.port).

Available options:

-conf FILE
specify Corefile to load, if not given CoreDNS will look for a Corefile in the current directory.
-dns.port PORT or -p PORT
override default port (53) to listen on.
-pidfile FILE
write PID to FILE.
-plugins
list all plugins and quit.
-quiet
don't print any version and port information on startup.
-version
show version and quit.
-windows-service
run as a Windows service (only available on Windows builds, default false).

Authors

CoreDNS Authors.

Apache License 2.0

See Also

Corefile(5) @@PLUGINS@@.