Troubleshooting

Service won't start

Symptom: The service shows Starting, then returns to Stopped almost immediately.

Common causes:

Cause	How to check	How to fix
Incorrect file path	The Status column shows ⚠ Path Missing	Right-click → Configure and update the path
Interpreter not found	The Status column shows ⚠ Runtime Missing	Right-click → Download Runtime… to fetch Node.js / Python / Ruby
Port already in use	Check the Port column of other services	Change the port in the service configuration
Error in the code	Open Service Watcher, look for an ERROR/STOPPED event	Fix the bug in the code, then restart

Diagnostic steps:

Open Service Watcher.
Find the most recent ERROR or STOPPED event for that service.
Read the description, it usually contains the service's stderr or a specific error message.

WinWraper shows "Circuit Open"

See Crash Recovery & Circuit Breaker for an explanation.

How to resolve:

Open Service Watcher and read the stderr from the crash events.
Fix the problem in the code or configuration.
Right-click → Restart to reset the circuit.

Service shows "Path Missing"

Symptom: The service is still in the list and its Status column shows ⚠ Path Missing.

Cause: The executable or script has been moved or deleted.

How to fix:

Right-click → Configure.
Update the path to the correct location.
Save and try starting again.

WinWraper opens twice

WinWraper allows only one instance running at a time. If you double-click the icon and no window appears:

Look for the WinWraper icon in the system tray and double-click it.
Or right-click the tray icon → 📋 Service List.

Can't activate the license

Check:

Do you have an internet connection?
Is the email and key entered correctly? (check for extra spaces)
Has the key already been activated on another machine without being deactivated first?

If none of these resolve it, contact: ptdung91dev@hotmail.com

Windows Service doesn't start after boot

Common causes:

The WinWraper service is missing permissions to run under the SYSTEM or Local Service account.
The service depends on a network connection or database that isn't ready at boot time.

How to check:

Open services.msc → find your service → check the Event Log in Properties.

Metrics shows no data

Cause: Metrics only starts recording when a service is running. If a service just started, wait at least 30 seconds for the first data point to appear.

Full reset of WinWraper

If WinWraper has a serious issue:

Exit WinWraper completely (tray icon right-click → Exit).
Open the data folder: %APPDATA%\WinWraper\
Delete wraper-state.json to reset all service configuration.

⚠️Warning

Deleting wraper-state.json removes all service entries you have added. Only do this as a last resort.

Contact support

If the problem persists after trying the steps above:

Email: ptdung91dev@hotmail.com
Website: boringtecvn.com

Next: Quick Reference →