Skip to content


Subversion checkout URL

You can clone with
Download ZIP
a simple zero-configuration command-line http server
JavaScript HTML

http-server: a command-line http server

http-server is a simple, zero-configuration command-line http server. It is powerful enough for production usage, but it's simple and hackable enough to be used for testing, local development, and learning.

Installing globally:

Installation via npm. If you don't have npm yet:

 curl | sh

Once you have npm:

 npm install http-server -g

This will install http-server globally so that it may be run from the command line.


 http-server [path] [options]

[path] defaults to ./public if the folder exists, and ./ otherwise.

Installing as a node app

 mkdir myapp
 cd myapp/
 jitsu install http-server

If you do not have jitsu installed you can install it via npm install jitsu -g


Starting http-server locally

 node bin/http-server

Now you can visit http://localhost:8080 to view your server

Deploy http-server to nodejitsu

 jitsu deploy

You will now be prompted for a subdomain to deploy your application on

Available Options:

-p Port to use (defaults to 8080)

-a Address to use (defaults to

-d Show directory listings (defaults to 'True')

-i Display autoIndex (defaults to 'True')

-e or --ext Default file extension if none supplied (defaults to 'html')

-s or --silent Suppress log messages from output

--cors Enable CORS via the Access-Control-Allow-Origin header

-o Open browser window after staring the server

-c Set cache time (in seconds) for cache-control max-age header, e.g. -c10 for 10 seconds (defaults to '3600'). To disable caching, use -c-1.

-P or --proxy Proxies all requests which can't be resolved locally to the given url. e.g.: -P

-S or --ssl Enable https.

-C or --cert Path to ssl cert file (default: cert.pem).

-K or --key Path to ssl key file (default: key.pem).

-r or --robots Provide a /robots.txt (whose content defaults to 'User-agent: *\nDisallow: /')

-h or --help Print this list and exit.

Something went wrong with that request. Please try again.