simple-web-server

README

simple web server

A simple (static) web server written in golang

Build and Run

Install by go,

go get github.com/mrinjamul/simple-web-server

Running with port 8081 and current directory,

simple-web-server -p 8081 -d "./" # port and directory optional

Running over HTTPS requires openssl key and openssl certificate to run.

you can download demo (key+certificate) from release section or generate with name server.key and server.crt.

To generate key and certificate,

$ openssl genrsa -out server.key 2048
$ openssl ecparam -genkey -name secp384r1 -out server.key
$ openssl req -new -x509 -sha256 -key server.key -out server.crt -days 3650

Running over HTTPS,

simple-web-server -d "./" --https -p 8443 -key "server.key" --cert "server.crt" # port and directory optional

Docker

Instant Use,

```sh
docker run --rm -it -p 8080:8080 --name myawesomeapp -v "$PWD":/home/app mrinjamul/sws:latest
```

Or,

To use in Docker Image,

docker pull mrinjamul/sws:latest

Sample Dockerfile for web page deployment,

FROM mrinjamul/sws:latest

WORKDIR /home/app

ADD . /home/app

COPY sws.json /etc/sws/config.json

CMD ["sws"]

And Now build the Image to use it on any project.

docker build -t [appname] .

Some defaults

• default port 8080 for http
• default port 443 for https (may require root to run)
• defualt directory "./"

Usage

Usage: simple-web-server [options]
Options:
-C, --cert string   openssl cert location for HTTPS
-d, --dir string    directory to serve
-h, --help          help message
-S, --https         serve over HTTPS
-k, --key string    openssl key location for HTTPS
-p, --port string   set port to serve
-v, --version       print version

License

• licensed under MIT