Skip to content

Mac Troubleshooting Guide

Jump to bottom
Jared Tate edited this page Mar 24, 2025 · 1 revision

Mac DigiByte Core Wallet Troubleshooting Guide

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

1. Check System Resources with Activity Monitor

Verify Available Memory:

  • Open Activity Monitor:
    • Navigate to Applications > Utilities > Activity Monitor.
  • Review Memory Usage:
    • Click the Memory tab to view current memory usage.
    • Ensure 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 System Logs with Console

Open Console:

  • Navigate to Applications > Utilities > Console.
  • Use the search or filter options to look for Error or Fault messages around the time of the crash.
  • Look for logs related to digibyte-qt or any other DigiByte Core Wallet processes.

3. Review DigiByte Core Wallet Logs

Locate the Debug Log:

  • The wallet’s data directory is typically located at:
    ~/Library/Application Support/DigiByte/
  • Open the debug.log file with a text editor.

What to Look For:

  • Error Messages & Warnings: Recurring issues or specific error messages.
  • Data Corruption: Indications of corrupted blockchain data.
  • Network Issues: Connectivity errors with DigiByte nodes.
  • Configuration Issues: Problems related to settings in the digibyte.conf file.

4. Additional Troubleshooting Steps

Antivirus and Security Software:

  • Interference: macOS security features or third-party antivirus software might block or delay certain wallet operations.
    • Temporarily disable any antivirus software to see if the issue persists.
    • Ensure the wallet is added to any exclusion lists if necessary.

Running with Elevated Privileges:

  • While macOS manages permissions differently, you may sometimes need to run commands with administrative rights via Terminal.

Software Updates:

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

5. Opening from an Unidentified Developer

macOS may block applications from unidentified developers by default.

How to Allow the Wallet to Open:

  • Right-Click Method:
    • In Finder, right-click (or Control-click) the DigiByte Core Wallet app.
    • Select Open from the context menu.
    • In the prompt that appears, click Open to confirm.
  • Security & Privacy Settings:
    • Open System Preferences > Security & Privacy > General.
    • If you see a message about DigiByte Core Wallet being blocked, click Allow Anyway.
  • Note:
    • Only bypass this warning if you trust the source of the wallet.

6. 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 on macOS:

  1. Open Terminal:
    • Navigate to Applications > Utilities > Terminal.
    • Important: Make sure to run Terminal with the necessary privileges. If needed, use sudo for administrative rights.
  2. Navigate to the Wallet’s Directory:
    • If the wallet is installed in your Applications folder, use a command like: 
      cd /Applications/DigiByte-Core.app/Contents/MacOS/
    • Adjust the path if your installation directory differs.
  3. Run the Reindex Command:
    • Type the following command and press Enter: 
      ./digibyte-qt -reindex
    • If required, prepend with sudo: 
      sudo ./digibyte-qt -reindex
  4. Wait for the Process to Complete:
    • Allow the wallet time to rescan and rebuild the blockchain index before attempting further use.

7. Still Having Issues?

If you have 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 helps improve the wallet for everyone.

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

Clone this wiki locally