Repository navigation
[v2 Windows] opencode2 hangs at "Starting background server..." after reinstall #41746
Description
Activity
This issue might be a duplicate of existing issues. Please check:
- opencode2 became stuck starting its managed background server #41696: Similar symptom — opencode2 hangs at "Starting background server..." / stuck starting its managed background server (different root cause suspected: port conflict vs. Windows reinstall, but the failure mode is the same)
If your issue is distinct from #41696, feel free to add that context to help maintainers differentiate them.
Thanks for the report. Could you reproduce this once more and share the relevant log output?
On Windows, the installed-build log is at:
%USERPROFILE%\.local\share\opencode\log\opencode.logPlease redact API keys, authorization headers, prompts, file contents, and any other sensitive data before sharing it.
Ran into this on Windows. In my case the timeout was caused by a port collision with Windows dynamic port reservations. On Windows, especially with Hyper-V, WSL2 or Docker installed it likes to reserve large blocks of ports.
The CLI hung and eventually threw:
- Error: Timed out waiting for the background service to start
Checking
~/.local/share/opencode/log/opencode.logshowed the actual error:- Managed service port 49374 on 127.0.0.1 is already in use by another process.
Running
netsh interface ipv4 show excludedportrange protocol=tcpconfirmed that Hyper-V/WSL had reserved ports
49336 to 49435, preventing the background service from binding to 49374.Setting an unreserved port resolved it:
powershell opencode service set port 40900 opencode service startTwo improvements would probably help here:
- Surface stderr from the background service in the CLI rather than silently waiting for the timeout.
- Retry with an alternate port (or request port 0 and persist what the OS assigns) when hitting EADDRINUSE / WSAEACCES.
Reacted by celery- added a commit that references this issue
on Sep 7, 2026 I get same issue on linux machine today
I'm getting the same issue. I have multiple users on my server, so the port can be blocked by other people
Description
Steps to reproduce:
npm uninstall -g @opencode-ai/clinpm install -g @opencode-ai/cli@0.0.0-next-17155opencode2→ hangs at "Starting background server..."Additional notes:
opencode2 servedirectly works fine (starts on port 4096)opencode2 --standaloneworks correctlyPlugins
No response
OpenCode version
opencode2 v0.0.0-next-17155
Steps to reproduce
Screenshot and/or share link
No response
Operating System
OS: Windows
Terminal
PowerShell