step fileserver

Name

step fileserver -- start an HTTP(S) server serving the contents of a path

Usage

step fileserver <dir>
[--address=<address>] [--cert=<file>] [--key=<file>] [--roots=<file>]

Description

step fileserver command starts an HTTP(S) server serving the contents of a file system.

This command is experimental and only intended for test purposes.

Positional arguments

dir The directory used as root for the HTTP file server.

Options

--address=address The TCP address to listen on (e.g. ":8443").

--cert=file The file containing the TLS certificate to use.

--key=file The file containing the key corresponding to the certificate.

--roots=file The file containing the root certificate(s) that will be used to verify the client certificates.

Examples

Start an HTTP file server on port 8080.

$ step fileserver --address :8080 /path/to/web-root

Start an HTTPS file server on 127.0.0.1:8443.

$ step ca certificate 127.0.0.1 localhost.crt localhost.key ... $ step fileserver --address 127.0.0.1:8443 \ --cert localhost.crt --key localhost.key /path/to/web-root

Start an HTTPS file server on a random port and require client certificates.

$ step fileserver --cert localhost.crt --key localhost.key \ --roots $(step path)/certs/root_ca.crt /path/to/web-root
Commands

    step

  • step fileserver