syncthing / syncthing/docs

Windows – stopping a service created via NSSM does not work

Open
#976 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
327
Forks
653
PR merge metrics
No merged PRs in 30d

Description

If Syncthing is installed on Windows as a service using NSSM, exactly as described in the documentation (--no-restart --no-browser --home=""), including the subsequent “final settings” (step 12), then after the initial service start (sc start "service name") it cannot be stopped by any means. The stopping process eventually times out, but the service never terminates. It cannot be stopped from the command line via SC or NSSM, nor from the GUI / MMC. To stop the service, it is necessary to kill the NSSM process.

This behavior was reproduced on two different Windows installations (Windows 10 LTSC and Windows Server 2019), with identical installation procedures, exactly according to the guide. The NSSM version was the latest available. The behavior was identical.

Workaround: After starting the service, stop Syncthing at least once from the browser/web interface running at ip:8384 (Actions / Restart). After doing this, the service can be stopped and started normally via MMC or from the command line (SC / NSSM). Until this is done, the service cannot be stopped.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Windows service setup and final settings described in the documentation, using the reported NSSM procedure. Reproduce the failed stop on Windows, then compare it with the browser restart workaround. Done means the service-stop behavior is explained or corrected in the documentation, with the workaround and expected result verified.

Written by the indexing model from the issue text.

Assessment

Domain
documentation, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.