grunt-http-server 1.X

Dependency Status
Dependency Status


This grunt task provides you with an http server to serve your static files that you can
hook in your grunt build.

Usage examples:

  • Host your jasmine tests from grunt
  • Test your single page application static html
  • Host static JSON responses for your tests
  • Test HTTPS support on your static web pages, tests, ...
  • ...

After run the grunt task (e.g. grunt http-server:dev) you can open on your browser.


npm install grunt-http-server



    'http-server': {

        'dev': {

            // the server root directory
            root: <path>,

            // the server port
            // can also be written as a function, e.g.
            // port: function() { return 8282; }
            port: 8282,

            // the host ip address
            // If specified to, for example, "" the server will
            // only be available on that ip.
            // Specify "" to be available everywhere
            host: "",

            cache: <sec>,
            showDir : true,
            autoIndex: true,

            // server default file extension
            ext: "html",

            // run in parallel with other tasks
            runInBackground: true|false,

            // specify a logger function. By default the requests are
            // sent to stdout.
            logFn: function(req, res, error) { },

            // Proxies all requests which can't be resolved locally to the given url
            // Note this this will disable 'showDir'
            proxy: "",

            /// Use 'https: true' for default module SSL configuration
            /// (default state is disabled)
            https: {
                cert: "cert.pem",
                key : "key.pem"

            // Tell grunt task to open the browser
            openBrowser : false,

            // customize url to serve specific pages
            customPages: {
                "/readme": "",
                "/readme.html": "README.html"





Copyright (c) 2015 Oscar Brito. Released under the MIT license.