| 
									
										
										
										
											2019-04-03 11:28:53 +01:00
										 |  |  | ## CoreDNS
 | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-10-09 15:24:18 +08:00
										 |  |  | *coredns* - pluggable DNS nameserver optimized for service discovery and flexibility. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ## Synopsis
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-01-28 11:13:11 +00:00
										 |  |  | *coredns* **[-conf FILE]** **[-dns.port PORT}** **[OPTION]**... | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | ## 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, | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | each described on <https://coredns.io/plugins> and their respective manual pages. Plugins not | 
					
						
							| 
									
										
										
										
											2019-04-03 11:28:53 +01:00
										 |  |  | bundled by default in CoreDNS are listed on <https://coredns.io/explugins>. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | 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 | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | it will start with the *whoami* plugin (coredns-whoami(7)) and start listening on port 53 (unless | 
					
						
							| 
									
										
										
										
											2019-02-27 15:02:50 +07:00
										 |  |  | overridden with `-dns.port`). | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | Available options: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | **-conf** **FILE** | 
					
						
							| 
									
										
										
										
											2019-04-21 22:38:40 +01:00
										 |  |  | : specify Corefile to load, if not given CoreDNS will look for a `Corefile` in the current | 
					
						
							|  |  |  |   directory. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | **-dns.port** **PORT** | 
					
						
							| 
									
										
										
										
											2018-06-13 11:02:14 +01:00
										 |  |  | : override default port (53) to listen on. | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | **-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. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Authors
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | CoreDNS Authors. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Copyright
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Apache License 2.0 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## See Also
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2018-01-06 15:53:33 +00:00
										 |  |  | Corefile(5) @@PLUGINS@@. |