This is a file server with a HTTP interface. It is currently implemented with Althttpd.

• althttpd (vendored)
• python3
• bwrap

Build althttpd with make then run:

./sodumb.sh [--port PORT] [--cert unsafe-builtin|CERT]

where CERT is the concatenation of a certificate and private key in PEM format. You can place it in the cert directory.

Althttpd supports HTTP Basic Authentication. The password is set by editing wwwroot/-auth.

• Download file:

  GET /data/NAME
  

• List files (names only, most recent first):

  GET /data
  

• Upload file:

  POST /data
  

  The request body must be multipart/form-data with one or more "file" fields, each with a "filename" parameter.

File names are restricted to the ASCII printable characters except:

SPACE
/       (directory separator)
\       (a common escape character, sometimes a directory separator)

A name may not begin with . or - because hidden files and files beginning with - are special to althttpd. In particular, the -auth file must not be clobbered.

data can be considered the bucket name, allowing the possibility of multiple buckets (if required).

Althttpd imposes a limit of MAX_CONTENT_LENGTH on HTTP requests (default: 250 million bytes).