https://github.com/nbari/www

web server for static content
https://github.com/nbari/www

ecc elliptic-curves hacktoberfest http-server https https-server letsencrypt server ssl static-server static-site static-website tls www

Last synced: about 1 month ago
JSON representation

web server for static content

• Host: GitHub
• URL: https://github.com/nbari/www
• Owner: nbari
• License: bsd-3-clause
• Created: 2016-11-12T08:50:49.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2024-07-22T17:22:36.000Z (6 months ago)
• Last Synced: 2024-12-07T04:15:31.863Z (about 2 months ago)
• Topics: ecc, elliptic-curves, hacktoberfest, http-server, https, https-server, letsencrypt, server, ssl, static-server, static-site, static-website, tls, www
• Language: Go
• Homepage:
• Size: 85.9 KB
• Stars: 51
• Watchers: 4
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# www

Static web server

[![download](https://img.shields.io/github/v/release/nbari/www)](https://github.com/nbari/www/releases)

[![Go Report Card](https://goreportcard.com/badge/github.com/nbari/www)](https://goreportcard.com/report/github.com/nbari/www)

Linux precompiled binaries

[![deb](https://img.shields.io/badge/deb-packagecloud.io-844fec.svg)](https://packagecloud.io/nbari/www)

[![rpm](https://img.shields.io/badge/rpm-packagecloud.io-844fec.svg)](https://packagecloud.io/nbari/www)

## Install on mac:

    $ brew tap nbari/homebrew-www

next

    $ brew install www

## Install on FreeBSD:

To install the port:

    $ cd /usr/ports/www/go-www/ && make install clean

To add the package:

    $ pkg install go-www

# Why ?

Because of the need to share, test via HTTP the contents of a directory.

# How it works

By typing ``www`` will start a web server and use as a document root the

directory where the command was call, a different document root may be specified

by using the ``-r`` option, for example:

    $ www -r /tmp

By default  **www** listen on port 8000, this can be changed by using the ``-p`` option:

    $ www -p 80 (may need root privilages)

If TLS is required use the option `-s` and a domain name, for example:

    $ www -s example.com

This will try to get a valid certificate by using letsencrypt but the port will always be 443

When using the ``-s`` use ``https`` option on the browser.

Example using tls and document root on port 8080:

    $ www -s localhost -r /tmp -p 8080