Skip to content
This repository was archived by the owner on Apr 25, 2024. It is now read-only.

maetthu/dirhttps

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dirhttps

Spinning up an HTTPS server from current directory - the TLS equivalent of python -m http.server.

Install

Use prebuilt binaries

or build from source

go get -u github.com/maetthu/dirhttps
$(go env GOPATH)/bin/dirhttps

Setup

dirhttps needs a certificate and corresponding key to operate. Easiest option is to use the excellent mkcert tool which creates locally trusted, self-signed development certificates.

  • Install and setup mkcert CA
  • Create dirhttps certificate
$ mkdir ~/.config/dirhttps
$ cd ~/.config/dirhttps
$ mkcert -cert-file cert.pem -key-file key.pem localhost 127.0.0.1 more.hostnames.or.ips.if.needed.example.org
  • Done

Usage

$ dirhttps -h 
Serving contents of current directory by HTTPS.

Usage:
  dirhttps [flags]

Flags:
      --cache           Enable client side caching
  -h, --help            help for dirhttps
  -l, --listen string   Listen address (default ":8443")
      --no-cors         Disable CORS handling
      --version         version for dirhttps

Examples

  • Basic usage
$ cd /tmp
$ dirhttps  
2019/03/31 13:40:26 Listening for HTTPS connections on :8443
2019/03/31 13:40:26 Serving from directory /tmp
  • Different listening address/port
$ dirhttps -l :1234
$ dirhttps -l 127.0.0.2:8443

About

Simple (almost) zero-config HTTPS daemon serving files from current directory

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors