====== Settings ======

<code>
doorhub settings              show them
doorhub set <name> <value>    change one
</code>

^ Setting ^ Default ^ What it does ^
| ''hub_name'' | Kalgoorlie Door Hub | Name shown at the top of the hub menu. Change it for your hub. |
| ''listen'' | '':2022'' | Address and port the hub listens on. '':2022'' means every address, port 2022. **Needs a restart.** |
| ''public_host'' | hub.example.com | Your hub's internet name. Goes into the connector ini that ''bbs add'' prints. |
| ''public_port'' | 2022 | The port members connect to. Can differ from ''listen'' if your router forwards another port. |
| ''backend_rlogin'' | ''127.0.0.1:513'' | Your Synchronet RLogin server. |
| ''jsexec'' | ''/sbbs/exec/jsexec'' or ''C:\sbbs\exec\jsexec.exe'' | Synchronet's jsexec program. |
| ''sbbs_ctrl'' | ''/sbbs/ctrl'' or ''C:\sbbs\ctrl'' | Synchronet's ctrl folder. |
| ''max_sessions_per_bbs'' | 10 | How many players one member BBS may have on the hub at once. 0 = no limit. |
| ''new_user_comment'' | Door Hub player | Comment put on users the hub makes, so you can find them in your user editor. |

Everything except ''listen'' applies straight away, even while the hub runs.

Settings live in the ''settings'' part of ''hub.json''. You can edit the file by hand, but the commands are safer: they lock the file so the running hub never reads half an edit.

===== The hub folder =====

All commands use the folder given by ''-d folder'', or the ''DOORHUB_DIR'' environment variable, or ''/opt/doorhub'' (Linux) / ''C:\doorhub'' (Windows).

<code>
doorhub -d /srv/hub2 settings
</code>

With ''-d'' you can run more than one hub on one machine, each with its own folder, ''listen'' port and service.