Caltech Library logo

ws

A nimble web server

ws is a prototyping platform for web based services and websites.

ws has a minimal feature set

Configuration

You can configure ws with command line options or environment variables. Try ws -help for a list of command line options.

Environment variables

Command line options

Running ws without environment variables or command line options is an easy way to server your current working directory’s content out as http://localhost:8000.

Need to quickly build out a website from Markdown files or other JSON resources? Take a look at mkpage.

Installation

ws is available as precompile binaries for Linux, Mac OS X, and Windows 10 on Intel. Additional binaries are provided for Raspbian on ARM6 adn ARM7. Follow the INSTALL.md instructions to download and install the pre-compiled binaries.

If you have Golang installed then ws can be installed with the go get command.

    go get github.com/caltechlibrary/ws/...

Compiling from source

Required

Here’s my basic approach to get things setup. Go 1.7 needs to be already installed.

  git clone https://github.com/caltechlibrary/ws
  cd ws
  go test
  go build
  go build cmds/ws/ws.go

If everything compiles fine then I do something like this–

  go install cmds/ws/ws.go

LICENSE

copyright © 2016 Caltech See LICENSE for details