aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md24
1 files changed, 22 insertions, 2 deletions
diff --git a/README.md b/README.md
index 803e6554e..99e2aae0b 100644
--- a/README.md
+++ b/README.md
@@ -110,7 +110,7 @@ on port `53` and enables `whoami` plugin is:
~~~
Sometimes port number 53 is occupied by system processes. In that case you can start the CoreDNS server
-while modifying the Corefile as given below so that the CoreDNS server starts on port 1053.
+while modifying the `Corefile` as given below so that the CoreDNS server starts on port 1053.
~~~ corefile
.:1053 {
@@ -118,9 +118,29 @@ while modifying the Corefile as given below so that the CoreDNS server starts on
}
~~~
-If you have a Corefile without a port number specified it will, by default, use port 53, but you can
+If you have a `Corefile` without a port number specified it will, by default, use port 53, but you can
override the port with the `-dns.port` flag: `coredns -dns.port 1053`, runs the server on port 1053.
+You may import other text files into the `Corefile` using the _import_ directive. You can use globs to match multiple
+files with a single _import_ directive.
+
+~~~ txt
+.:53 {
+ import example1.txt
+}
+import example2.txt
+~~~
+
+You can use environment variables in the `Corefile` with `{$VARIABLE}`. Note that each environment variable is inserted
+into the `Corefile` as a single token. For example, an environment variable with a space in it will be treated as a single
+token, not as two separate tokens.
+
+~~~ txt
+.:53 {
+ {$ENV_VAR}
+}
+~~~
+
A Corefile for a CoreDNS server that forward any queries to an upstream DNS (e.g., `8.8.8.8`) is as follows:
~~~ corefile