| 
									
										
										
										
											2019-10-10 07:45:28 +01:00
										 |  |  | .\" Generated by Mmark Markdown Processer - mmark.miek.nl | 
					
						
							|  |  |  | .TH "COREDNS" 1 "October 2019" "CoreDNS" "CoreDNS" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | .SH "COREDNS" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | .PP | 
					
						
							| 
									
										
										
										
											2019-10-10 07:45:28 +01:00
										 |  |  | \fIcoredns\fP - pluggable DNS nameserver optimized for service discovery and flexibility. | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | .SH "SYNOPSIS" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | .PP | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | \fIcoredns\fP \fB[-conf FILE]\fP \fB[-dns.port PORT}\fP \fB[OPTION]\fP... | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | .SH "DESCRIPTION" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | .PP | 
					
						
							|  |  |  | 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 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | \[la]https://coredns.io/plugins\[ra] and their respective manual pages. Plugins not | 
					
						
							|  |  |  | bundled by default in CoreDNS are listed on https://coredns.io/explugins | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \[la]https://coredns.io/explugins\[ra]. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | .PP | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | When started without options CoreDNS will look for a file named \fB\fCCorefile\fR in the current | 
					
						
							|  |  |  | directory, if found, it will parse its contents and start up accordingly. If no \fB\fCCorefile\fR is found | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | it will start with the \fIwhoami\fP plugin (coredns-whoami(7)) and start listening on port 53 (unless | 
					
						
							|  |  |  | overridden with \fB\fC-dns.port\fR). | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | .PP | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | Available options: | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | .TP | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \fB-conf\fP \fBFILE\fP | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | specify Corefile to load, if not given CoreDNS will look for a \fB\fCCorefile\fR in the current | 
					
						
							|  |  |  | directory. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | .TP | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \fB-dns.port\fP \fBPORT\fP | 
					
						
							|  |  |  | override default port (53) to listen on. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | .TP | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \fB-pidfile\fP \fBFILE\fP | 
					
						
							|  |  |  | write PID to \fBFILE\fP. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | .TP | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \fB-plugins\fP | 
					
						
							|  |  |  | list all plugins and quit. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | .TP | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \fB-quiet\fP | 
					
						
							|  |  |  | don't print any version and port information on startup. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | .TP | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | \fB-version\fP | 
					
						
							|  |  |  | show version and quit. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | .SH "AUTHORS" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | .PP | 
					
						
							|  |  |  | CoreDNS Authors. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | .SH "COPYRIGHT" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | .PP | 
					
						
							|  |  |  | Apache License 2.0 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | .SH "SEE ALSO" | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | .PP | 
					
						
							| 
									
										
										
										
											2019-10-10 07:45:28 +01:00
										 |  |  | Corefile(5) coredns-k8s_external(7) coredns-erratic(7) coredns-nsid(7) coredns-any(7) coredns-hosts(7) coredns-acl(7) coredns-dnssec(7) coredns-health(7) coredns-grpc(7) coredns-sign(7) coredns-file(7) coredns-root(7) coredns-autopath(7) coredns-auto(7) coredns-clouddns(7) coredns-dnstap(7) coredns-pprof(7) coredns-tls(7) coredns-loadbalance(7) coredns-cache(7) coredns-ready(7) coredns-whoami(7) coredns-bind(7) coredns-loop(7) coredns-import(7) coredns-chaos(7) coredns-template(7) coredns-azure(7) coredns-log(7) coredns-kubernetes(7) coredns-forward(7) coredns-debug(7) coredns-secondary(7) coredns-route53(7) coredns-errors(7) coredns-metrics(7) coredns-reload(7) coredns-rewrite(7) coredns-metadata(7) coredns-etcd(7) coredns-cancel(7) coredns-trace(7). | 
					
						
							| 
									
										
										
										
											2019-04-06 08:42:40 +01:00
										 |  |  | 
 |