Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An instant file server from your command line
branch: master
Failed to load latest commit information.
bin converted bin line endings to UNIX format
examples close #2 verified that multipart form uploads work
test adding some tests and examples for uploading newfiles
.gitignore initial commit
package.json updated whitespace


instant file server (ifs) turns any directory into an instant file server, and it runs directly from your command line. Install it once per machine and then run it in as many directories as you'd like.

Watch the IFS video tutorial!

HTTP Conventions

  • GET - reads the contents a file from the specified path
  • POST - overwrite or create a file
  • PUT - update the contents of a file (not implemented)
  • DELETE - delete a file from the system


instant-server can be installed via Node Package Manager.

Best results when you install globally using the -g flag on NPM.

$ npm install -g ifs
$ (ifs is added to your PATH; go anywhere on your system)
$ ifs -help
$ ifs [arguments...]
... starting ifs on


Using ifs is easy - after installing it globally, run it anywhere on the commandline:

$: ifs [-port #] [-hostname <host>] [-d <directory>]

And it'll start automatically.

See more ifs examples.

Something went wrong with that request. Please try again.