https://github.com/singpolyma/shttpd

An HTTP server written in POSIX shell script
https://github.com/singpolyma/shttpd

Last synced: about 1 month ago
JSON representation

An HTTP server written in POSIX shell script

• Host: GitHub
• URL: https://github.com/singpolyma/shttpd
• Owner: singpolyma
• License: other
• Created: 2010-01-27T02:20:07.000Z (almost 15 years ago)
• Default Branch: master
• Last Pushed: 2024-01-02T18:59:27.000Z (12 months ago)
• Last Synced: 2024-10-15T11:34:33.935Z (3 months ago)
• Language: AMPL
• Homepage:
• Size: 11.7 KB
• Stars: 44
• Watchers: 8
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • License: COPYING

Awesome Lists containing this project

README

        
= shttpd =

shttpd is an HTTP server written entirely in POSIX shell script.

== Why? ==

Because you can!  Also, there are some real advantages:

* Compact, understandable codebase

* Trivial to configure/extend

* Run from anywhere and just start serving!

* Get lots of nice debug output in your terminal

== Running ==

To start an instance of the server just run:

./shttpd -p  -C  -m modules/dirlist.mod:modules/static.mod

You can list whatever modules you want to load (order matters!) but this will get you started.

== Extending ==

Writing modules is easy!  Look a the ones in the modules directory for examples.

Basically, you write some shell code that gets sourced into the server, and manipulate the environment according to your needs.

== Deploying ==

Each instance of the server can only handle one connection, so you will need some other server to round-robin proxy.

You may also configure inetd to call the server with -i