srv

srv is a tiny web server for local deployments. I found it useful for development and testing of static websites and blogs

Installation

$ cabal install srv

build from source

$ git clone https://github.com/thma/srv.git
$ cd srv
$ stack install 

-- or if you don't have stack installed

$ cabal install

Usage

$ cd /path/to/your/documentRoot
$ srv

starting up srv...
srv.yaml not found, generating file with default config
Starting HTTP server on port 8080
Starting HTTPS server on port 8443

During the initial run, srv will create a config file srv.yaml in the current directory.

You can edit this file to change the port, the directory to serve, and also select whether to handle HTTP or HTTPS or both.

If HTTPS is selected, you can also provide a certificate and key file. If you don't provide both files, srv will use a predefined self-signed certificate which is meant for local demo use only. (using this demo certificate will result in a warning in your browser and some browsers will even refuse to connect.)

By default, srv will serve the current directory. You can change this by editing the entry documentRoot in the srv.yaml file.

By default srv will also open a browser window pointing to the directory configured in documentRoot. This behaviour can be changed by setting the entry autoOpenBrowser to false.

Configuration

Here is a sample configuration file:

autoOpenBrowser: true
documentRoot: .
handlers:
- - HTTP
  - 8080
- - HTTPS
  - 8443
pathToCert: /path/to/certificate.pem
pathToKey: /path/to/key.pem

How to generate your own certificate

openssl genrsa -out key.pem 2048
openssl req -new -key key.pem -out certificate.csr
openssl x509 -req -in certificate.csr -signkey key.pem -out certificate.pem