jinghui/hermes-webui
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: block duplicate webui start when launchd owns 8787

Browse Source
This commit is contained in:
Andy Kang authored and nesquena-hermes committed 2026-05-31 23:02:23 +00:00
1 parent f24d633189
commit 91717b7e47
3 files changed
+72
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/supervisor.md
+2
View File
@@ -16,6 +16,8 @@ Or set ``HERMES_WEBUI_FOREGROUND=1`` in the environment. The Web UI will
auto-detect launchd / systemd / supervisord even without the flag, but being
explicit is safer.
**Important (launchd on macOS):** if the ``com.parantoux.hermes-webui`` LaunchAgent is enabled, treat launchd as the single source of truth for WebUI lifecycle. Do **not** also run ``./ctl.sh start``, ``bash start.sh``, ``python bootstrap.py``, or ``python server.py`` against the same state dir/port, or you can create a second WebUI instance and trigger port-8787 restart churn.
## Why ``--foreground`` matters
Without it, ``bootstrap.py`` does this: