[Bug]: Fast Startup on Windows corrupts netclient .json/.bak config files, service fails to start and requires manual cleanup + re-join
Author: MainRabotCreated Jun 5, 2026Updated Jun 25, 2026
Labelsbug
Contact Details
What happened?
Bug description
When Windows Fast Startup (Fast Boot) is enabled, the netclient configuration becomes completely corrupted after the computer is shut down and powered on again. The service does not start, and manual start attempts fail with an error. The only way to restore functionality is to:
- Navigate to the
netclientinstallation folder (e.g.,C:\Program Files\netclient) - Manually delete all
.jsonand.bakfiles - Re-join the network using
netclient.exe -join TOKEN
This is a data corruption issue, not just a service start failure.
Steps to reproduce
- Enable Fast Startup in Windows:
- Control Panel → Power Options → Choose what the power buttons do → Turn on fast startup (recommended).
- Install
netclientand successfully join a network:netclient.exe -join TOKEN - Verify the service is working (e.g.,
wg showshows interface, connectivity works). - Shut down the computer (do not restart).
- Power on the computer.
- After boot, check service status:
Get-Service netclient- Service is
Stopped
- Service is
- Attempt to start the service manually:
Start-Service netclient- The command returns an error:
Start-Service : Failed to start service 'netclient' - In
services.msc, clicking "Start" shows: "Windows could not start the netclient service on Local Computer." - The service cannot be started by any means
- The command returns an error:
- Examine the
netclientinstallation folder:- Configuration files (
.json,.bak) are present but corrupted
- Configuration files (
- Workaround applied:
cd "C:\Program Files\netclient" Remove-Item *.json, *.bak .\netclient.exe -join TOKEN
Version
v1.5.1
What OS are you using?
Windows
Relevant log output
Contributing guidelines
- Yes, I did.
Source: gravitl/netmaker