Documentation space

Appearance

Download Wiresock Secure Connect
Enhanced WireGuard VPN Client for Windows
Wiresock Secure Connect screenshot

Effective Troubleshooting using wiresock-client.exe ​

Comprehensive Logging and Analysis ​

Enabling Detailed Logging ​

When experiencing issues with WireSock Secure Connect, enable verbose logging. Start the application or service with the -log-level all option to generate a comprehensive debug log.

  • Application Mode: The debug log will appear directly in the console window.
  • Service mode: Log files are stored at C:\ProgramData\NT KERNEL\WireSock VPN Client.

Network Traffic Analysis ​

For thorough network analysis, the WireSock VPN Client captures all processed network packets in PCAP format. These files are essential for troubleshooting and can be analyzed using tools like Wireshark.

Storage location: By default, PCAP files are saved in the service’s working directory, typically C:\Windows\System32 when running as a service.

Performance Considerations

Note: The -log-level all setting is intended for debugging only due to the extensive data it captures. Using this log level regularly is not recommended, as it may significantly impact application performance.

Application Initialization Issues ​

If you encounter a problem where WireSock Secure Connect gets stuck during launch—showing a continuous initialization process and nothing else—it usually indicates an issue with the background services, a corrupted configuration, or problematic connection profiles.

Continuous initialization process

To resolve this issue, you can try the following methods. We recommend starting with Method 1.

Method 1: Check Windows Services ​

First, ensure that the background services required for WireSock are running:

  1. Press Win + R, type services.msc, and press Enter.

  2. Locate the services related to WireSock (look for any services that have "WireSock" in their name).

    Windows Services Window

  3. For each WireSock service, if its status is not Running, right-click on it and select Start. Verify that their status successfully updates to Running, as shown in the picture below.

    Service Running State

  4. After starting the services, WireSock Secure Connect should automatically complete its initialization. If it doesn't, try restarting the application.

Method 2: Reset Configuration and Profiles ​

If the services are already running or starting them didn't help, you might need to clear your application configuration and profiles.

  1. Reset application configuration: Try deleting the application configuration file located at:
    C:\ProgramData\WireSock Foundation\WireSock Secure Connect\wiresock.config
    Often, this is enough to resolve the startup issue. Launch the application again to check if it's fixed.
  2. Backup and delete connection profiles: If deleting the configuration alone does not help, navigate to the application's profiles directory at:
    C:\ProgramData\WireSock Foundation\WireSock Secure Connect\Profiles
    Crucially, copy your existing profiles to a safe location first as a backup. Once safely backed up, delete the profiles from the application directory.
  3. Restart the application: Launch WireSock Secure Connect again to see if the issue is resolved.

If the problem persists, please check the Comprehensive Logging and Analysis section to gather more details for troubleshooting.

Support and Assistance ​

If you encounter issues or have questions, our support team is here to help. Visit our FAQs for quick answers or use the to connect with other users and receive personalized assistance. We're committed to ensuring you have the best experience with WireSock Secure Connect.