Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A free, simple, tiny (1 java file!), nicely embeddable HTTP server in Java.
Branch: master
Pull request Compare This branch is even with gseguin:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Features & limitations

  • Only one Java file
  • Java 1.1 compatible
  • Released as open source, Modified BSD licence
  • No fixed config files, logging, authorization etc. (Implement by yourself if you need them.)
  • Supports parameter parsing of GET and POST methods
  • Parameter names must be unique. (Adding support to multiple instance of a parameter is not difficult, but would make the interface a bit more cumbersome to use.)
  • Supports both dynamic content and file serving
  • Supports file upload (since version 1.2, 2010)
  • Never caches anything
  • Doesn't limit bandwidth, request time or simultaneous connections
  • Default code serves files and shows all HTTP parameters and headers
  • File server supports directory listing, index.html and index.htm
  • File server does the 301 redirection trick for directories without /
  • File server supports simple skipping for files (continue download)
  • File server uses current directory as a web root
  • File server serves also very long files without memory overhead
  • Contains a built-in list of most common mime types
  • All header names are converted lowercase so they don't vary between browsers/clients

Ways to use

  • Run as a standalone app (serves files from current directory and shows requests)
  • Subclass serve() and embed to your own program (see for a simple example)
  • Call serveFile() from serve() with your own base directory
  • To test file uploading, try browsing file-upload-test.htm through NanoHTTPD, upload something and watch the console output.
Something went wrong with that request. Please try again.