Skip to content
a simple zero-configuration command-line http server
Find file
New pull request
Pull request Compare This branch is 206 commits behind indexzero:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

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.


Installation is 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.

If you cannot install npm, you can always clone the source directly:

 git clone git://
 cd http-server
 node bin/http-server


 http-server [path] [options]

The entire /mypath tree will now be available at http://localhost:8080/.

Available Options:

-p Port to listen for connections on (defaults to 8080)

-a Address to bind to (defaults to 'localhost')

-i Display AutoIndex (defaults to 'True')

-s or --silent In silent mode, log messages aren't logged to the console.

-h or --help Displays a list of commands and exits.

Something went wrong with that request. Please try again.