Starkserver NPM

StarkServer

StarkServer is a simple, easy to use, and highly configurable web server written for NodeJS. I wanted a way to have a website up in seconds, without all of the extra gunk offered by other webservers.

With StarkServer, you can:

Specify certain filetypes you'd like to serve.
Host multiple domains from the same server (virtual hosts).
Serve over HTTP and HTTPS.
Easily write new Drivers to output to the web in any language.

Tech

StarkServer uses the following technologies to serve your pages:

node.js
- fs
- path
- http
- https
- recursive-readdir
- mime-types
- simple-node-logger

Installation

StarkServer requires Node.js v4.5+ to run.

Download and extract the latest release.

Install the dependencies.

$ cd StarkServer
$ npm install

Configure

There exists a JSON config file that is already setup with the options that are needed, just with generic inputs. You will need to make sure the ports are the ones you wish to bind to, the baseDirectory is set (the directory of your website), and any Drivers are setup if you need them. An example from my config looks like this:

var config = {
    ports: {
        http: 80,
        https:443
    },
    ssl: {
        cert:'/home/www/certs/fullchain.pem',
        key: '/home/www/certs/key.pem'
    },
    domains: {
        localhost:{
                host            :['localhost', '127.0.0.1', 'hostname'],
                baseDirectory   :'/home/www/mywebsite',
                allowedFileTypes:['js','css','html'],
                index:'index.html',
                filesToIgnore: ['.gitignore'],
                directoriesToIgnore:['.git']
        }
    },
    drivers: {
        name: {
            DriverFile: 'drivers/php.js',
            fileTypes:['php']
        }
    }
};

module.exports = config;