Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A web server written in bash
Pull request Compare This branch is 3 commits ahead of gdb:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

bashttpd is a basic web server.


  1. bash, any recent version should work
  2. socat or netcat to handle the underlying sockets (I.e., 'socat TCP4-LISTEN:8080,fork EXEC:/usr/local/bin/', or 'netcat -lp 8080 -e ./')
  3. A healthy dose of insanity


  1. Serves text, HTML and binary files
  2. Shows directory listings

Limitations (PATCHES WELCOME!):

  1. Does not support authentication


  1. No input filtering yet.

HTTP protocol support: 403: Returned when a directory is not listable, or a file is not readable 400: Returned when the first word of the first line is not GET 200: Returned with valid content Content-type: Bashttpd uses /usr/bin/file to determine the MIME type to sent to the browser 1.0: The server doesn't support Host: headers or other HTTP/1.1 features - it barely supports HTTP/1.0!

I believe it is possible to have a fairly complete HTTP server written in shell, and I welcome any patches to it!

Something went wrong with that request. Please try again.