dromas-server

Overview ¶

Command dromas-server is the dromas.dev server.

dromas-server serve -boxes-table T -msgs-table T -accounts-table T -bucket B -names NAMES [-listen addr] [options] [limits]
dromas-server serve --dev [-listen addr] [limits]
dromas-server account create -accounts-table T [-id NAME] [-unmetered]
dromas-server account key -accounts-table T -account ID -uses N -ttl D
dromas-server account drop -boxes-table T -accounts-table T -account ID -box ADDR
dromas-server limits clear -socket PATH -ip ADDR

The first keeps state in three DynamoDB tables, boxes, messages and accounts, and an S3 Express One Zone directory bucket (ARCHITECTURE.md § Storage), with AWS credentials from the usual chain; it answers 503 until its stream followers are positioned, loads each box into memory on its first use, and exits if a stream follower loses its place, since a restart rebuilds memory.

--dev keeps everything in memory, with no AWS: the honest server every client tests against. Nothing survives a restart. It takes a pass made for any name, unless -names is given.

account is the operator's hand on accounts (PROTOCOL.md §11.16) until accounts have users who log in: create one, mint an adopt key for it, or drop a box from it.