Skip to content

Windows Troubleshooting Guide

Jump to bottom
Jared Tate edited this page Mar 24, 2025 · 4 revisions

Windows DigiByte Core Wallet Troubleshooting Guide

This guide is designed to help you diagnose and resolve crashes with the DigiByte Core Wallet on Windows. Before proceeding with any other troubleshooting steps, please use Task Manager to ensure your system has at least 12 GB of available RAM. This is a critical requirement for the smooth operation of the wallet.

1. Check System Resources with Task Manager

Verify Available Memory:

  • Open Task Manager:
    • Press Ctrl + Shift + Esc or right-click the taskbar and select Task Manager.
  • Review Memory Allocation:
    • Click the Performance tab and select Memory to view current usage.
    • Confirm that your system has at least 12 GB of available RAM.
  • If Memory is Low:
    • Close unnecessary applications to free up memory.
    • Consider upgrading your system's RAM if you consistently run low on available memory.

2. Check Windows Event Viewer Logs

Open Event Viewer:

  • Press Windows + R.
  • Type eventvwr.msc and press Enter.

Navigate to Application Logs:

  • In the left pane, expand Windows Logs and select Application.
  • Look for Error or Critical entries around the time of the crash.
  • Double-click an entry to view details such as:
    • Faulting Application Name: Likely listed as digibyte-qt.exe or similar.
    • Fault Module Name: Indicates the module or DLL that caused the crash.
    • Exception Code: Use this for further troubleshooting research.

3. Review DigiByte Core Wallet Logs

Locate the Debug Log:

  • Navigate to the wallet’s data directory, typically at:
    %APPDATA%\Digibyte\
  • Open the debug.log file with a text/code editor.

What to Look For:

  • Error Messages & Warnings: Identify any recurring issues or specific error messages.
  • Data Corruption: Look for indications of corrupted blocks or database errors.
  • Network Issues: Check for connectivity errors with DigiByte nodes.
  • Configuration Issues: Errors related to misconfigurations in the digibyte.conf file.

4. Additional Troubleshooting Steps

Antivirus and Security Software:

  • Interference: Antivirus programs might incorrectly flag wallet components.
    • Temporarily disable your antivirus to see if the crash persists.
    • Add the DigiByte Core Wallet to your antivirus exclusion list if necessary.

Running as Administrator:

  • Right-click the DigiByte Core Wallet shortcut.
  • Select Run as administrator to ensure the app has the necessary permissions to access files and network resources.

Software Updates:

  • Confirm you are using the latest version of the DigiByte Core Wallet.
  • Ensure your Windows system and drivers are up-to-date.

5. Advanced: Reindexing and Resyncing

If the debug log suggests blockchain data corruption, you can rebuild the blockchain index by running the wallet with the -reindex option.

Running the Reindex Command:

  1. Open an Administrative Command Prompt:
    • Press Windows + X and select Command Prompt (Admin) or Windows PowerShell (Admin).
      It is essential to run the command prompt as an administrator for this operation.
  2. Navigate to the Wallet’s Directory:
    • Use the cd command to change to the directory containing digibyte-qt.exe.
  3. Run the Reindex Command:
    • Type the following command and press Enter: 
      digibyte-qt.exe -reindex
    • This command will rebuild the blockchain index, which may resolve issues related to corrupted blockchain data.
  4. Wait for the Process to Complete:
    • The wallet may take some time to rescan and rebuild the index. Allow it to complete before attempting further use.

6. Still Having Issues?

If you've followed this guide and the DigiByte Core Wallet continues to crash or experience issues, please consider filing an issue on the official GitHub repository. Your feedback can help improve the wallet for everyone.

Follow these steps to pinpoint the cause of crashes and take the necessary corrective actions. If you find more information or additional issues using this guide, please paste the details here and let us know.

Clone this wiki locally