Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Simple static stuff server
JavaScript
branch: master
Failed to load latest commit information.
bin Initial commit
lib Initial commit
.gitignore Initial commit
Readme.md This repository is no longer maintained
package.json Initial commit

Readme.md

Simple static stuff server

NOTE: This project is no longer maintained. It was created against a very old version of Node. It no longer functions. This repository is kept for historical reasons, but no one should actually use it.

Ever needed to send a colleague a file, but can't be bothered emailing the 100MB beast? Wanted to run a simple example JavaScript application, but had problems with running it through the file:/// protocol? Wanted to share your media directory at a LAN without setting up Samba, or FTP, or anything else requiring you to edit configuration files? Then this file server will make your life that little bit easier.

To install the simple static stuff server, use npm:

npm install -g static-server

Then to serve a file or a directory, simply run

$ serve path/to/stuff
Serving path/to/stuff on port 8001

Or serve your current directory by running it with no arguments:

$ pwd
/home/tim/public
$ serve
Serving /home/tim/public on port 8001

Serve an individual file, or a whole directory. Files are sent with their correct mime-types. Directories are browsable. Stuff is downloadable. Any index.html file is served by default, so you can serve stand-alone JavaScript apps or static web sites. Point your browser to http://localhost:8001/, or someone else's browser to http://[your-ip-address]:8001/ and your work is done.

For a quick, handy way of finding your ip address, try running ip addr or ifconfig

The port to serve stuff on can be set using the --port flag, in case you need to change it.

$ serve /etc/passwd --port 1234
Serving /etc/passwd on port 1234

Serving out of the default http port of 80 is supported, but most Linux systems will require you to have root privileges to bind to port 80:

$ sudo serve ~/my-javascript-app/ --port 80
Serving ~/my-javascript-app/ on port 80

And that is it!

Something went wrong with that request. Please try again.