Readme

About

Supermatic is a simple HTTP server I wrote just for fun as a Bourne Shell script. It supports minimal features and should not be considered for use in production.
There are no warranties. Don't expect it to be secure or bug free!

Supported features and standards

Supermatic is more or less POSIX compliant, it can run on FreeBSD and on any other OS which has Bourne Shell and inetd-like daemon. Supermatic serves GET requests for directory listing, static HTML and TXT files along with GIF, JPEG and PNG image formats. And what's about any other standards and features? No, never heard of them.

Installation and configuration

Download Supermatic and unarchive it into the desired directory
At least, change the RootDir variable in the smhttpd.conf file
Populate www directory with your own content
Change the owner of the RootDir and all subdirectories, user nobody is a good choice for it

Add someting like that to /etc/inetd.conf:

smhttpdsh	stream	tcp	nowait		nobody	/usr/local/supermatic/smhttpd.sh smhttpd.sh /usr/local/supermatic/smhttpd.conf

And this line to /etc/services:
```
smhttpdsh		8080/tcp
```
Configure and start/restart inetd daemon
Access the server at: http://your-server-address:8080. To troubleshoot and diagnose check logs in the log directory
Configure external log rotation of access.log and server.log files since their growth is not controlled by Supermatic

CHANGELOG

2018.11.17	v0.5	The first public release
2018.11.18	v0.5.1	MIME types update
2020.05.15	v0.5.2	Syntax cleaning
2020.05.16	v0.6	Configuration file, AccessLog enhancements
2020.05.20	v0.7	Directory listing, HEAD method
2020.07.11	v0.7.1	Fixed 501 Error handling
2020.07.18	v0.7.2	Fixes URL compilation and URLs in directory listing
2020.07.19	v0.8.0	Basic access authentication
2020.07.19	v0.8.1	Exclude files from directory listing
2020.07.19	v0.8.2	Directory samples and index.html update
2020.07.19	v0.8.3	Busybox workaround for ls time formatting

TODO

Directory listing
Support more MIME formats
HTTPS
CGI-BIN, embedded scripts and preprocessing PHP, Perl, Python, etc
All other modern features and options

There are a lot of things to do. I implement them all, someday in the future. Probably not ;)

License and warranties

There are no warranties at all!

Supermatic is licensed under the BEER-WARE License

FAQ

Q: Is it possible to run Supermatic as a standalone "daemon"?

A: Yes, on some OS Supermatic can be started in standalone mode utilizing /dev/tcp facility or using netcat. If you want netcat'ed version, contact me, because it's outdated and has issues with muliplexing connections.

Q: What's up? Your pages look like they came from 2000!

A: No surprises, it's because I wrote them in the pure vi editor.

Supermatic by Mikhail Zakharov, 2018, 2020 BEER-WARE License