.nh
.TH "Caddy" "8" "Nov 2026" "Auto generated by spf13/cobra" ""

.SH NAME
caddy-file-server - Spins up a production-ready file server


.SH SYNOPSIS
\fBcaddy file-server [--domain ] [--root ] [--listen ] [--browse] [--reveal-symlinks] [--access-log] [--precompressed] [flags]\fP


.SH DESCRIPTION
A simple but production-ready file server. Useful for quick deployments,
demos, and development.

.PP
The listener's socket address can be customized with the --listen flag.

.PP
If a domain name is specified with --domain, the default listener address
will be changed to the HTTPS port and the server will use HTTPS. If using
a public domain, ensure A/AAAA records are properly configured before
using this option.

.PP
By default, Zstandard and Gzip compression are enabled. Use --no-compress
to disable compression.

.PP
If --browse is enabled, requests for folders without an index file will
respond with a file listing.


.SH OPTIONS
\fB-a\fP, \fB--access-log\fP[=false]
	Enable the access log

.PP
\fB-b\fP, \fB--browse\fP[=false]
	Enable directory browsing

.PP
\fB-v\fP, \fB--debug\fP[=false]
	Enable verbose debug logs

.PP
\fB-d\fP, \fB--domain\fP=""
	Domain name at which to serve the files

.PP
\fB-f\fP, \fB--file-limit\fP=10000
	Max directories to read

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for file-server

.PP
\fB-l\fP, \fB--listen\fP=""
	The address to which to bind the listener

.PP
\fB--no-compress\fP[=false]
	Disable Zstandard and Gzip compression

.PP
\fB-p\fP, \fB--precompressed\fP=[]
	Specify precompression file extensions. Compression preference implied from flag order.

.PP
\fB--reveal-symlinks\fP[=false]
	Show symlink paths when browse is enabled.

.PP
\fB-r\fP, \fB--root\fP=""
	The path to the root of the site

.PP
\fB-t\fP, \fB--templates\fP[=false]
	Enable template rendering


.SH SEE ALSO
\fBcaddy(8)\fP, \fBcaddy-file-server-export-template(8)\fP


.SH HISTORY
1-Nov-2026 Auto generated by spf13/cobra