Pyramid

A Cloudron community app that packages pyramid — a hierarchical Nostr community relay by fiatjaf.

Pyramid turns a single Nostr relay into a walled, self-organizing community. Members invite other members (up to a configurable quota), every member is responsible for their descendants, and anyone can leave at any time. On top of the invite tree, pyramid runs a family of independent subrelays over a single shared memory-mapped store:

• main — the basic pyramid relay; only members can publish.

• internal — a relay private to members, for reading and writing.

• favorites — notes from external users, manually curated by members.

• inbox — a spam-filtered inbox that only accepts notes from the extended social graph of members.

• popular / uppermost — auto-curated feeds based on member reactions and interactions.

• moderated — a public relay where members approve each post manually.

• personal — per-member private note storage.

• groups — moderated NIP-29 group functionality with an optional embedded LiveKit server for audio/video.

• No external database — all events live in memory-mapped files under /app/data; the only Cloudron addon required is localstorage.

• No TLS to manage — Cloudron terminates TLS at the edge; pyramid runs plain HTTP internally and derives its advertised wss/https URLs from the domain you enter on the setup page.

• Self-update disabled — Cloudron ships app updates via image rebuilds, so pyramid's built-in self-updater is turned off.

First-run setup: the relay domain is pre-seeded to the Cloudron app subdomain automatically, so the only remaining step is to open the app location in a browser and paste the root member's Nostr public key (npub or hex) at /setup/root. Until that is done, every other path redirects to /setup/root. The platform health check uses /static/icon.png, which is served even before setup completes, so the app reports healthy while you finish configuration.

Security posture: the subdomain is reachable from the public internet (Nostr clients must be able to reach the relay over WebSocket). Pyramid does not use Cloudron SSO — membership is governed entirely by Nostr keys and the invite tree. Put the app behind Cloudron Access Control only if you understand that it will block all Nostr client WebSocket traffic.