mirror of
https://github.com/coredns/coredns.git
synced 2026-04-05 11:45:33 -04:00
84 lines
1.5 KiB
Groff
84 lines
1.5 KiB
Groff
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
|
|
.TH "COREDNS-ROOT" 7 "March 2026" "CoreDNS" "CoreDNS Plugins"
|
|
|
|
.SH "NAME"
|
|
.PP
|
|
\fIroot\fP - simply specifies the root of where to find files.
|
|
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
The default root is the current working directory of CoreDNS. The \fIroot\fP plugin allows you to change
|
|
this. A relative root path is relative to the current working directory.
|
|
\fBNOTE: The \fIroot\fP directory is NOT currently supported by all plugins.\fP
|
|
Currently the following plugins respect the \fIroot\fP plugin configuration:
|
|
|
|
.IP \(bu 4
|
|
\fIfile\fP
|
|
.IP \(bu 4
|
|
\fItls\fP
|
|
.IP \(bu 4
|
|
\fIdnssec\fP
|
|
|
|
|
|
.PP
|
|
This plugin can only be used once per Server Block.
|
|
|
|
.SH "SYNTAX"
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
root PATH
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fBPATH\fP is the directory to set as CoreDNS' root.
|
|
|
|
.SH "EXAMPLES"
|
|
.PP
|
|
Serve zone data (when the \fIfile\fP plugin is used) from \fB\fC/etc/coredns/zones\fR:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
\&. {
|
|
root /etc/coredns/zones
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
When you use the \fIroot\fP and \fItls\fP plugin together, your cert and key should also be placed in the \fIroot\fP directory.
|
|
The example below will look for \fB\fC/config/cert.pem\fR and \fB\fC/config/key.pem\fR
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
tls://example.com:853 {
|
|
root /config
|
|
tls cert.pem key.pem
|
|
whoami
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH "BUGS"
|
|
.PP
|
|
\fBNOTE: The \fIroot\fP directory is NOT currently supported by all plugins.\fP
|
|
Currently the following plugins respect the \fIroot\fP plugin configuration:
|
|
|
|
.IP \(bu 4
|
|
\fIfile\fP
|
|
.IP \(bu 4
|
|
\fItls\fP
|
|
.IP \(bu 4
|
|
\fIdnssec\fP
|
|
|
|
|