mirror of
https://github.com/coredns/coredns.git
synced 2025-11-03 18:53:13 -05:00
20c5f55802
DNSSEC keys can be specified relative to `root`: https://github.com/coredns/coredns/blob/master/plugin/dnssec/setup.go#L135 Co-authored-by: Nicolai Søborg <NicolaiSoeborg@users.noreply.github.com>
57 lines
1.2 KiB
Markdown
57 lines
1.2 KiB
Markdown
# root
|
|
|
|
## Name
|
|
|
|
*root* - simply specifies the root of where to find files.
|
|
|
|
## Description
|
|
|
|
The default root is the current working directory of CoreDNS. The *root* plugin allows you to change
|
|
this. A relative root path is relative to the current working directory.
|
|
**NOTE: The *root* directory is NOT currently supported by all plugins.**
|
|
Currently the following plugins respect the *root* plugin configuration:
|
|
|
|
* *file*
|
|
* *tls*
|
|
* *dnssec*
|
|
|
|
This plugin can only be used once per Server Block.
|
|
|
|
## Syntax
|
|
|
|
~~~ txt
|
|
root PATH
|
|
~~~
|
|
|
|
**PATH** is the directory to set as CoreDNS' root.
|
|
|
|
## Examples
|
|
|
|
Serve zone data (when the *file* plugin is used) from `/etc/coredns/zones`:
|
|
|
|
~~~ corefile
|
|
. {
|
|
root /etc/coredns/zones
|
|
}
|
|
~~~
|
|
|
|
When you use the *root* and *tls* plugin together, your cert and key should also be placed in the *root* directory.
|
|
The example below will look for `/config/cert.pem` and `/config/key.pem`
|
|
|
|
~~~ txt
|
|
tls://example.com:853 {
|
|
root /config
|
|
tls cert.pem key.pem
|
|
whoami
|
|
}
|
|
~~~
|
|
|
|
## Bugs
|
|
|
|
**NOTE: The *root* directory is NOT currently supported by all plugins.**
|
|
Currently the following plugins respect the *root* plugin configuration:
|
|
|
|
* *file*
|
|
* *tls*
|
|
* *dnssec*
|