Error #62953

Activity

1. opencodejr commented on Nov 9, 2026

   

   opencodejrBot

   on Nov 9, 2026

   More actions

   Thanks for the report, @matizdz! (Feel free to reply in French.)

   Background service failed to start is a generic message. It means the Desktop app's background service started but then reported that its own startup failed, and the real cause isn't in this error. Several different problems end in this same message, so could you share:

   1. OpenCode version: shown in the Desktop app, or from opencode --version.
   2. Operating system, and how you installed the app (installer from opencode.ai, package manager, etc.).
   3. When it happens: on every launch, only after an update, after waking from sleep, or something else? Did an earlier version work?
   4. The service log: the most recent entries from opencode.log around the failed launch. It is in ~/.local/share/opencode/log/ (on Windows, %USERPROFILE%\.local\share\opencode\log\). If you have the opencode CLI, the output of opencode service stop followed by opencode serve --service --print-logs --log-level debug also helps. Please remove anything sensitive first.

   If it started right after an update, running opencode service stop and then reopening the app may get you going again (see #62326).

   Possibly related issues, ordered by likelihood:

   • Windows: "Background service failed to start" after update until opencode service stop is run #62326: "Background service failed to start" after an update, until opencode service stop is run
   • Starting background server... Error: Background service failed to start #57032: same message, caused by a permission error (EPERM on chmod) on the database file
   • desktop: background service spawn fails "port in use" on Windows/WSL2 mirrored networking — app stuck at logo, error not logged #55907: background service fails to start because its port is already in use (Windows/WSL2)
   • 桌面端打开报错，kill端口和set新端口都无法解决 #54071: Desktop startup error from a port conflict on Windows

   You can reply here with the details, or edit the issue. If you edit it, please also leave a comment saying you've updated it so we know you're done editing.
2. opencodejr

   added

   triaging

   on Nov 9, 2026