summaryrefslogtreecommitdiff
path: root/docs/MAINS_PROXY.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/MAINS_PROXY.md')
-rw-r--r--docs/MAINS_PROXY.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/MAINS_PROXY.md b/docs/MAINS_PROXY.md
new file mode 100644
index 0000000..7573cbe
--- /dev/null
+++ b/docs/MAINS_PROXY.md
@@ -0,0 +1,37 @@
+# mains_proxy · HyBBX 2.8.0
+
+Opt-in mesh linking Main or Secondary instances for `/proxymail` and `/proxychat`.
+
+## Feature matrix
+
+| Feature | Supported |
+|---------|-----------|
+| `/proxymail` cross-site | yes |
+| `/proxychat` cross-site | yes |
+| User account sync | no |
+| Sysop actions over proxy | no |
+| Raw Main-to-Main TCP bypass | no — HBX/Circuit only |
+
+## Build matrix
+
+| Item | Value |
+|------|-------|
+| CMake | `-DHYBBX_PLUGIN_MAINS_PROXY=ON` |
+| INI | `[networks] mains_proxy=yes` |
+| Template | `share/hybbx-mesh.ini.example` |
+| Auth | Same as Secondary — `link_id`, `link_password` |
+
+## Topology matrix
+
+| Peer A | Peer B | Transport |
+|--------|--------|-----------|
+| Main | Main | HBX circuit client |
+| Main | Secondary | HBX circuit client |
+| Secondary | Secondary | via Main hub (typical) |
+
+## Related
+
+| Goal | Doc |
+|------|-----|
+| Topology | [TOPOLOGY.md](TOPOLOGY.md) |
+| Manual | [MANUAL.md](MANUAL.md) |
git clone -b <branch> https://cgit.mode42.com/<repo>.git
git clone -b <branch> git://cgit.mode42.com/<repo>.git

info@mode42.com