[Bug]: Title: Internal API Port (9005) fails to start - CLI commands not working
Platform
Windows
Operating system version
Windows 11 Pro
System architecture
Windows
Herd Version
1.23.0.0
PHP Version
No response
Bug description
Bug Description The Internal API Port (port 9005) fails to start when running Herd on Windows, preventing all CLI commands from working. The HerdHelper service starts correctly on port 5001, but the Electron app's internal HTTP server never binds to port 9005.
Environment • Herd Version: 1.23.0.0 • OS: Windows 10 Build 26200 • Shell: PowerShell 5.1.26100.7019 • Windows Defender: Active (exclusions added for Herd)
Expected Behavior • Internal API Port should show green/online status • Port 9005 should be listening on localhost • CLI commands should work normally
Actual Behavior • Internal API Port shows red/offline • Port 9005 is never opened (verified with netstat -ano) • Only port 5001 (HerdHelper) is listening • All CLI commands fail
What I've Tried
- ✅ Installed HerdHelper service: herd install-helper - Service running correctly
- ✅ Reinstalled Herd completely
- ✅ Ran Herd as Administrator
- ✅ Cleared cache (%APPDATA%\Herd and %LOCALAPPDATA%\Herd)
- ✅ Added Windows Defender exclusions for: ◦ C:\Program Files\Herd ◦ %USERPROFILE%.config\herd ◦ Process: Herd.exe ◦ Process: HerdHelper.exe
- ✅ Checked Windows Firewall - rules are present and enabled
Steps to reproduce
Steps to Reproduce
- Install Herd for Windows
- Start Herd application (with or without administrator privileges)
- Check the "Internal API Port" status in Settings - shows red/offline
- Attempt to run any CLI command: herd --version
- Error: "The Herd Desktop application is not running. Please start Herd and try again."
Relevant log output
# HerdHelper is running
Get-Service HerdHelper
# Name: HerdHelper, Status: Running, StartType: Automatic
# Port 5001 is listening
netstat -ano | findstr "5001"
# TCP 127.0.0.1:5001 LISTENING
# Port 9005 is NOT listening
netstat -ano | findstr "9005"
# (no output)