mirror of
https://github.com/profullstack/agentbbs.git
synced 2026-08-13 22:37:28 +00:00
README: add hosting requirements (RAM, tiny-droplet SKIP_BUILD, Ubuntu 24.04); fix pod image default
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
c272ed8a05
commit
41a8ff240d
1 changed files with 16 additions and 1 deletions
17
README.md
17
README.md
|
|
@ -55,7 +55,7 @@ Configuration (env):
|
||||||
| `AGENTBBS_HOST` | `bbs.profullstack.com` | hostname shown in messages |
|
| `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_ADMINS` | unset | operator account names for `admin@` (comma/space-separated) — see [docs/admin.md](docs/admin.md) |
|
||||||
| `AGENTBBS_SANDBOX` | `auto` | `bwrap` / `prlimit` / `none` |
|
| `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_MEM` / `AGENTBBS_POD_CPUS` | `512m` / `1` | pod caps |
|
||||||
| `AGENTBBS_POD_KEEP` | unset | `1` keeps pods running after disconnect |
|
| `AGENTBBS_POD_KEEP` | unset | `1` keeps pods running after disconnect |
|
||||||
| `COINPAY_API_KEY` | unset | CoinPay API key (Premium payments) |
|
| `COINPAY_API_KEY` | unset | CoinPay API key (Premium payments) |
|
||||||
|
|
@ -70,6 +70,21 @@ Ops:
|
||||||
|
|
||||||
## Deploy
|
## 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
|
The production host (`bbs.profullstack.com`) is provisioned by the idempotent
|
||||||
[`setup.sh`](setup.sh) and stays current automatically:
|
[`setup.sh`](setup.sh) and stays current automatically:
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue