memoryhttpd

memoryhttpd is an in-memory HTTP server. Resources can be added by using PUT. It supports multiple hosts.

For example:

$ curl -v http://localhost:3000/foo/bar/ -H Host:example.com -X PUT -d 'hello world'
> PUT /foo/bar/ HTTP/1.1
> Host:example.com
> Content-Length: 11
> 
< HTTP/1.1 200 OK
< x-memoryhttpd-action: set
< content-length: 11
< date: Thu, 09 Mar 2023 20:32:07 GMT
< 
hello world
$ curl -v http://localhost:3000/foo/bar/ -H Host:example.com
> GET /foo/bar/ HTTP/1.1
> Host:example.com
> 
< HTTP/1.1 200 OK
< content-length: 11
< date: Thu, 09 Mar 2023 20:33:22 GMT
< 
hello world
$ curl -v http://localhost:3000/foo/bar/ -H Host:example.net
> GET /foo/bar/ HTTP/1.1
> Host:example.net
> User-Agent: curl/7.85.0
> Accept: */*
> 
< HTTP/1.1 404 Not Found
< content-length: 0
< date: Thu, 09 Mar 2023 20:33:28 GMT
< 

Commands

Set a value:

PUT /full/path HTTP/1.1
Host: hostname
Content-Length: 5

value

Get a value:

GET /full/path HTTP/1.1
Host: hostname

Delete a value:

DELETE /full/path HTTP/1.1
Host: hostname

Set with an expiration (in milliseconds):

PUT /full/path HTTP/1.1
Host: hostname
X-Expire-ms: 30000
Content-Length: 21

value expiring in 30s

Use cases

acme challenges

memoryhttpd can be used to store temporary tokens. For example using it as a backend for /.well-known/acme-challenges/ for a reverse proxy.

Mirrors

This repository is mirrored on:

• https://codeberg.org/acatton/memoryhttpd
• https://github.com/acatton/memoryhttpd