From 41a8ff240d982833527f361a7860c720d320e967 Mon Sep 17 00:00:00 2001 From: Anthony Ettinger Date: Sun, 14 Jun 2026 10:18:46 +0000 Subject: [PATCH] README: add hosting requirements (RAM, tiny-droplet SKIP_BUILD, Ubuntu 24.04); fix pod image default Co-Authored-By: Claude Opus 4.8 --- README.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 9120eac..7fa3b9a 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,7 @@ Configuration (env): | `AGENTBBS_HOST` | `bbs.profullstack.com` | hostname shown in messages | | `AGENTBBS_ADMINS` | unset | operator account names for `admin@` (comma/space-separated) — see [docs/admin.md](docs/admin.md) | | `AGENTBBS_SANDBOX` | `auto` | `bwrap` / `prlimit` / `none` | -| `AGENTBBS_POD_IMAGE` | `debian:stable-slim` | pod base image | +| `AGENTBBS_POD_IMAGE` | `ubuntu:24.04` | pod base image | | `AGENTBBS_POD_MEM` / `AGENTBBS_POD_CPUS` | `512m` / `1` | pod caps | | `AGENTBBS_POD_KEEP` | unset | `1` keeps pods running after disconnect | | `COINPAY_API_KEY` | unset | CoinPay API key (Premium payments) | @@ -70,6 +70,21 @@ Ops: ## Deploy +### Hosting requirements + +- **RAM: 1 GB minimum, 2 GB recommended.** The core BBS (SSH hub, arcade, web) + is light, but each member gets a **Docker pod** (a full container), so RAM is + the real constraint once people use pods. +- **512 MB is marginal** — it runs, but idles into swap and can't host more than + a pod or two. On a 512 MB box also lower `AGENTBBS_POD_MEM` (e.g. `256m`). +- **Building needs ~1.5 GB+** (LiveKit/redis/modernc deps). Tiny droplets can't + compile on-box — build elsewhere and copy the binaries, then run + `SKIP_BUILD=1 ./setup.sh` (it uses the prebuilt `/usr/local/bin/{agentbbs,ascii-live}` + and adds swap automatically). +- **OS: Ubuntu 24.04** (handles socket-activated `sshd` when moving admin to `:2202`). + +### Continuous deploy + The production host (`bbs.profullstack.com`) is provisioned by the idempotent [`setup.sh`](setup.sh) and stays current automatically: