Skip to main content
This guide explains how to use the Qoder diagnostic script to troubleshoot startup and connectivity issues with Qoder. The script automatically collects critical system information, including environment details, network settings, Qoder service status, and relevant logs, enabling quick diagnosis and resolution of common problems.

​
Prerequisites

Before running the diagnostic script, ensure the following:
  • Operating System: Windows
  • Permissions: Run the script with administrator privileges for full access to system settings and logs.
  • Script file: Download and save the windows_Qoder.bat script as a .bat file (example: qoder_Debug.bat).
  • Installation path: Confirm that Qoder is installed in the default directory C:\Users\<YourUsername>\.qoder.

​
Run the diagnostic script

​
Step 1: Run the script

  1. Locate the saved .bat file.
Example: qoder_Debug.bat
  1. Double-click the file to execute the script.
  2. The script will run automatically, collecting system and application data.
⚠️ Allow the script to complete fully. Do not close the command window prematurely.

​
Step 2: View the generated log

Once the script finishes:
  • It will automatically open the generated log file.
  • The log file path will be displayed in the command window.
  • By default, the log is saved in the same directory as the script, with a filename in the format: Qoder_Log_YYYYMMDD_HHMMSS.txt.
    • Example: Qoder_Log_20250405_143022.txt

​
Common issues

Issue typeIssueSolution
NetworkCheck proxy settingsThe script checks whether a proxy is enabled. Review the section [Network Settings 0x0 means proxy is disabled] to confirm expected behavior.
If a proxy is in use, manually configure the network proxy for Qoder in the settings.
Qoder Server StatusExistence of Qoder.exeThe script verifies if Qoder.exe exists.
If an error occurs:
1. Check the installation path.
2. Delete the .qoder directory.
3. Restart your IDE to regenerate the directory.
Version and startup testCheck the [Version Test] and [Start Qoder] sections to confirm:
* Qoder version
* Connection to the public server
If it shows “failed,” use the URL from the error message to configure proxy access in settings.
Qoder.exe running but logon failsAdd the executable to Windows Firewall whitelist:
Path:
1. windows：C:\Users\用户名\AppData\Local\Programs\Qoder\resources\app\resources\bin`CPU_architecture_64_system\Qoder.exe<br/>2. Mac：/Applications/Qoder.app/Contents/Resources/app/resources\bin\CPU_architecture_64_system`\Qoder
Steps:
Control Panel → System and Security → Windows Defender Firewall → Allowed Apps → Allow another app
Then retry login.
System compatibilitySystem and hardware informationThe script collects:
* OS version (e.g., Windows 10/11)
* CPU model
Check [Operating System Information] to ensure your system meets Qoder’s requirements:
* Windows 10 or later (64-bit)
* x86_64-compatible CPU
Log analysisQoder application logsThe generated log includes the last 80 lines of qoder.log.
Use this to identify runtime errors, warnings, or connection issues.
Directory structure and file sizeThe script lists the full directory structure and file sizes under .qoder. Use this to:
* Check disk usage.
* Verify file integrity (such as missing or abnormally small files).
NoteBinary execution restrictionsSome corporate environments restrict or block binary execution, which may prevent Qoder from running.
If the app fails to start, contact your IT department for permission adjustments.
Unresolvable issuesIssues beyond self-troubleshootingIf you cannot resolve the issue, contact us at: contact@qoder.com.
Please attach the generated log file: Qoder_Log_YYYYMMDD_HHMMSS.txt for faster support.
⌘I