Table of Contents

Hub on Windows

The Windows hub works the same as the Linux one, with a Windows service. Synchronet for Windows must be on the same machine. First prepare the door BBS: the sbbs.ini and modopts.ini changes are the same on Windows.

The Windows hub was tested under Wine with a stand-in BBS. It hasn't yet been run against a real Synchronet for Windows; reports welcome.

Install

1. Make a folder C:\doorhub and copy doorhub.exe from doorhub-0.1.0-windows-x64.zip into it. (Another folder works too; then add -d C:\your\folder to every command, or set the environment variable DOORHUB_DIR.)

2. Open a Command Prompt as Administrator and run:

cd C:\doorhub
doorhub init

init makes hub.json and the host key and prints the key's fingerprint. Give it to member sysops so they can check it.

3. If Synchronet isn't in C:\sbbs:

doorhub set jsexec D:\sbbs\exec\jsexec.exe
doorhub set sbbs_ctrl D:\sbbs\ctrl

4. Name the hub, set the address members will use, and add games and members:

doorhub set hub_name "Example Door Hub"
doorhub set public_host hub.example.com
doorhub door add lord LORD "Legend of the Red Dragon"
doorhub bbs add EXB "The Example BBS"

See Games and Member BBSes.

5. Try it:

doorhub serve

Windows Firewall asks whether doorhub.exe may accept connections. Allow it on the networks your members connect from. Ctrl+C stops it.

Run it as a service

From the Administrator Command Prompt, in C:\doorhub:

doorhub service install
doorhub service start

The service is Door Hub (DoorHub). It starts with Windows, runs as Local System, and restarts itself if it stops. Its log is C:\doorhub\doorhub.log. You can also start and stop it in services.msc.

doorhub service stop
doorhub service remove

The service remembers the folder it was installed from (it runs doorhub.exe -d C:\doorhub serve). If you move the folder, remove and install the service again.

Notes