====== Door Hub ======

Door Hub lets several BBSes share one set of door games. Callers on every member BBS play in the same games as each other, as if the games ran on their own board. It works the same way as DoorParty: each member BBS runs a small **connector**, and the connector sends callers to the **hub** through an encrypted SSH tunnel.

Door Hub is free software under the GNU GPL (version 2 or later). It runs on Linux (x64 and arm64) and Windows (64-bit), and works with Synchronet; Mystic and other BBS programs can join a hub through RLogin.

  * Downloads: [[https://retro.theiguru.au/doorhub/|retro.theiguru.au/doorhub]]
  * Current version: **0.1.0** (9 November 2026). See [[doorhub:history|version history]].

===== How it works =====

<code>
 caller --> member BBS --RLogin--> connector ==SSH tunnel==> hub --RLogin--> door BBS
            (any BBS)              (on the member's PC)       (doorhub)     (Synchronet with the games)
</code>

  - A caller picks a hub game on their own BBS. The BBS opens an RLogin connection to the connector on the same machine, with the caller's name, a password made for that caller, and a game code.
  - The connector puts the BBS's **system tag** in front of the name, for example ''[KAL]Heisenberg'', and passes the connection to the hub through an SSH tunnel. Each member BBS has its own hub account.
  - The hub checks the account and the tag. The first time it sees a player it makes them a user on its own Synchronet BBS (the **door BBS**), called ''Heisenberg (KAL)''.
  - The hub logs that user in to the door BBS and starts the game straight away. When the game ends the caller is back on their own BBS (or back at the hub menu, if they came through it).

Callers never log on to the hub themselves and never see a password. Member BBSes only make outgoing connections, so they don't need to open anything on their router.

===== Which page do I need? =====

^ You are... ^ Read ^
| A sysop who wants to offer hub games to your callers | [[doorhub:join_a_hub|Joining a hub]], then [[doorhub:connector|The connector]] and [[doorhub:synchronet_member|Synchronet set-up]] or [[doorhub:other_bbs|Mystic and other BBS programs]] |
| A sysop who wants to host games for other BBSes | [[doorhub:running_a_hub|Running a hub]], then [[doorhub:hub_linux|Linux]] or [[doorhub:hub_windows|Windows]] |
| Looking after a running hub | [[doorhub:games|Games]], [[doorhub:member_bbses|Member BBSes]], [[doorhub:players|Players]], [[doorhub:commands|Command reference]] |
| Stuck | [[doorhub:troubleshooting|Troubleshooting]] |

===== The Kalgoorlie Door Hub =====

The Kalgoorlie Retro BBS runs a Door Hub with these games:

^ Game ^ Code ^ About ^
| Esterian Conquest | ''ec'' | Turn-based space conquest: claim planets and build fleets; turns run once a day |
| Legend of the Red Dragon 4.06 | ''lord'' | The classic fantasy door, with the Apothecary, Grizelda's, the Latrine, Barak's House, the Dragon Vault and the Pawn Shop |
| TradeWars 2002 (Kalgoorlie Local) | ''tw'' | The classic space trading game, a universe of its own on the hub |
| TradeWars 2002 (TWGS Galaxy Server) | ''twgs'' | The same TradeWars Game Server games as the Kalgoorlie Retro BBS |
| Barren Realms Elite | ''bre'' | Build an empire on a barren planet: land, armies, trade and alliances |

Sysops who would like to join can email [[slaterm@theiguru.au]] for an account. Tell us your BBS name and the system tag you'd like.

===== All pages =====

**Joining a hub:** [[doorhub:join_a_hub|Joining a hub]] · [[doorhub:connector|The connector]] · [[doorhub:synchronet_member|Synchronet set-up]] · [[doorhub:other_bbs|Mystic and other BBS programs]]

**Running a hub:** [[doorhub:running_a_hub|Running a hub]] · [[doorhub:hub_linux|Hub on Linux]] · [[doorhub:hub_windows|Hub on Windows]] · [[doorhub:settings|Settings]] · [[doorhub:games|Games]] · [[doorhub:member_bbses|Member BBSes]] · [[doorhub:players|Players]] · [[doorhub:internet_and_security|Internet and security]] · [[doorhub:logs_and_backups|Logs and backups]] · [[doorhub:commands|Command reference]]

**Everyone:** [[doorhub:troubleshooting|Troubleshooting]] · [[doorhub:building|Source and building]] · [[doorhub:history|Version history]]