Skip to content

Troubleshooting and bug reports

Stevex edited this page Nov 11, 2026 · 3 revisions

Device not detected

Unlock the device, reconnect it over USB, and accept its trust prompt. On Windows, install Apple Devices or iTunes. On Linux, ensure usbmuxd and libimobiledevice are installed and the usbmuxd service/socket is available. Then restart GoldenNugget and refresh the device list.

Apply or restore failed

Keep the device connected and read the error shown in the app log. Do not delete the protective backup or cache while recovery may be needed. If the app is waiting for a device to return, unlock the device and allow it time to reconnect. Use Settings → Backup → Restore Data From Backup when you need to recover protected data.

Report a bug

If GoldenNugget shows an error window, report the bug from there: it opens a GitHub issue with the error details already filled in. Otherwise, open a new GitHub issue yourself. Include the app version, operating system, iOS version, exact steps, expected result, actual result, and relevant error text.

To attach diagnostics, open Settings → Support → App Log and choose Export Diagnostics. The same log window opens from Open application log on the apply result card. Review and edit the preview before saving or sharing the ZIP. It contains selected app details and a redacted log tail; it is saved locally and is not uploaded automatically. Avoid attaching backup files, pairing records, or secrets to a public issue.

Clone this wiki locally