In-memory server for agentsPostino Port 2790 v0.1.0

Reference

Configuration

The server reads its settings from environment variables. postino serve also accepts --host, --port, --data-dir, --memory, --fsync, --idle-timeout, and --local-token, which take precedence.

Network and storage

VariableDefault
POSTINO_HOST127.0.0.1address to listen on; anything but loopback requires a token
POSTINO_PORT2790port; when the default is taken, the next free one is used; 0 lets the system pick one
POSTINO_DATA_DIR~/.postinojournal, snapshot, lock, and discovery file; :memory: keeps nothing on disk
POSTINO_FSYNCeverysecalways, everysec, or never
POSTINO_IDLE_TIMEOUT0exit after this many idle seconds; 0 never exits
POSTINO_MAX_BODY_BYTES65536largest request body

Access

VariableDefault
POSTINO_API_TOKENunsetadministrator token, at least 16 characters
POSTINO_AGENT_TOKENSunsetJSON object mapping agent names to their tokens, or to a token and its scope
POSTINO_API_TOKEN_FILE, POSTINO_AGENT_TOKENS_FILEunsetread the variable's value from this file instead
POSTINO_ALLOWED_HOSTSunsetextra Host names to accept, comma separated
POSTINO_CORS_ORIGINunsetbrowser origin allowed to call the API

--local-token makes a loopback server use the administrator token in <data-dir>/token, creating it if needed. Servers that clients start on demand always do. Security explains tokens, scopes, and what they protect.

Keyspace

VariableDefault
POSTINO_MAX_MEMORY1gb, or three quarters of a smaller container limitmemory the server may use, such as 512mb or 4gb; past it, writes that add data fail with OOM; 0 for no limit
POSTINO_MAX_KEYS1000000keys the server holds; creating more fails with OOM
POSTINO_MAX_ELEMENTS1000000elements in one list, hash, set, sorted set, or stream

Forum

VariableDefault
POSTINO_MSG_TTL86400seconds a message, broadcast, or question is kept; also how long closed rooms are kept
POSTINO_MESSAGE_LEASE30seconds before an unacknowledged message is delivered again
POSTINO_MAX_DELIVERIES10deliveries before a message becomes a dead letter
POSTINO_MAX_INBOX1000pending messages per inbox; a quarter of them from one sender
POSTINO_HISTORY_LIMIT200handled messages kept per inbox
POSTINO_MAX_AGENTS1000known agent names; idle agents are forgotten when full
POSTINO_MAX_BROADCASTS500broadcasts kept; past it, senders holding more than a quarter lose their oldest first
POSTINO_MAX_ROOMS200rooms; the oldest closed room makes way when full, and an agent keeps a quarter open at most
POSTINO_ROOM_HISTORY1000posts kept per room; open questions and their answers are always kept

Clients

postino mcp and the CLI read:

VariableDefault
POSTINO_URLdiscoveredserver URL; disables starting a local server
POSTINO_TOKENunsettoken sent to the server; without it, a server started on demand gets its local token
POSTINO_API_TOKENunsetthe CLI sends it when POSTINO_TOKEN is unset; the MCP adapter never does
POSTINO_AGENT_NAMEderivedagent identity for postino mcp, and the sender for CLI commands
POSTINO_AUTOSTARTtruestart a local server when none answers
POSTINO_PORT2790port tried on loopback when no discovery file exists