A simple zero-configuration command-line http server

Downloads in past


12,9001350.9.08 years ago8 years agoMinified + gzip package size for spa-http-server in KB


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:
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

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 starting 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.
-U or --utc Use UTC time format in log messages.
-P or --proxy Proxies all requests which can't be resolved locally to the given url. e.g.: -P
--push-state Enable HTML5 push state mode where all URIs respond with index.html. (defaults to 'False')
-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.