You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Jeromy Streets 71cd7aa74c
Updated Go compiler to 1.20.7 and rolled release version. (#103)
9 months ago
.github add-dependabot 2 years ago
bin/serve Added command-line utility packages and integrated. 6 years ago
cli feat: add-show-index 2 years ago
config feat: add-show-index 2 years ago
handle set CORP header (#97) 10 months ago
img Working around HTML limits in GitHub markdown. 3 years ago
.dockerignore Creating multi-arch building container and consolidated version to Dockerfiles. 5 years ago
.gitignore Adding the output from script to .gitigore. 1 year ago
Dockerfile Updated Go compiler to 1.20.7 and rolled release version. (#103) 9 months ago
Dockerfile.all Updated Go compiler to 1.20.7 and rolled release version. (#103) 9 months ago
LICENSE Initial commit 7 years ago Attempt to clarify typo :) (#99) 10 months ago
go.mod has a vunerability #70 2 years ago
go.sum has a vunerability #70 2 years ago Bash formatting and lint corrections in 1 year ago



Tiny, simple static file server using environment variables for configuration. Install from any of the following locations:


Environment Variables

Default values are shown with the associated environment variable.

# Enables resource access from any domain.

# Enable debugging for troubleshooting. If set to 'true' this prints extra
# information during execution. IMPORTANT NOTE: The configuration summary is
# printed to stdout while logs generated during execution are printed to stderr.

# Optional Hostname for binding. Leave unset to accept any incoming HTTP request
# on the prescribed port.

# If assigned, must be a valid port number.

# When set to 'true' the index.html file in the folder will be served. And
# the file list will not be served.

# Automatically serve the index of file list for a given directory (default).

# Folder with the content to serve.

# URL path prefix. If 'my.file' is in the root of $FOLDER and $URL_PREFIX is
# '/my/place' then file is retrieved with 'http://$HOST:$PORT/my/place/my.file'.

# Paths to the TLS certificate and key. If one is set then both must be set. If
# both set then files are served using HTTPS. If neither are set then files are
# served using HTTP.

# If TLS certificates are set then the minimum TLS version may also be set. If
# the value isn't set then the default minimum TLS version is 1.0. Allowed
# values include "TLS10", "TLS11", "TLS12" and "TLS13" for TLS1.0, TLS1.1,
# TLS1.2 and TLS1.3, respectively. The value is not case-sensitive.

# List of accepted HTTP referrers. Return 403 if HTTP header `Referer` does not
# match prefixes provided in the list.
# Examples:
#   'REFERRERS=http://localhost,https://...,'
#   To accept missing referrer header, add a blank entry (start comma):
#   'REFERRERS=,http://localhost,'

# Use key / code parameter in the request URL for access control. The code is
# computed by requested PATH and your key.
# Example:
#   ACCESS_KEY=username
#   To access your file, either access:
#   http://$HOST:$PORT/my/place/my.file?key=username
#   or access (md5sum of "/my/place/my.fileusername"):
#   http://$HOST:$PORT/my/place/my.file?code=44356A355E89D9EE7B2D5687E48024B0

YAML Configuration File

YAML settings are individually overridden by the corresponding environment variable. The following is an example configuration file with defaults. Pass in the path to the configuration file using the command line option ('-c', '-config', '--config').

cors: false
debug: false
folder: /web
host: ""
port: 8080
referrers: []
show-listing: true
tls-cert: ""
tls-key: ""
tls-min-vers: ""
url-prefix: ""
access-key: ""

Example configuration with possible alternative values:

debug: true
folder: /var/www
port: 80
    - http://localhost


Without Docker

PORT=8888 FOLDER=. ./serve

Files can then be accessed by going to http://localhost:8888/my/file.txt

With Docker

docker run -d \
    -v /my/folder:/web \
    -p 8080:8080 \

This will serve the folder "/my/folder" over http://localhost:8080/my/file.txt

Any of the variables can also be modified:

docker run -d \
    -v /home/me/dev/source:/content/html \
    -v /home/me/dev/files:/content/more/files \
    -e FOLDER=/content \
    -p 8080:8080 \

Getting Help

./serve help
# OR
docker run -it halverneus/static-file-server:latest help