Troubleshooting¶
When a drive misbehaves, work through these first:
- Disconnect and reconnect the drive.
- Check your internet connection — most errors are connectivity.
- If sign-in is involved, re-authenticate when RaiDrive asks.
- See which program is holding files with the Process Monitor.
Storage-specific problems are covered in each storage guide's Troubleshooting section — see Storage.
Collect logs for support¶
When you report a problem — on the community forum or to support@raidrive.com — attach the log folder, compressed:
%ProgramData%\OpenBoxLab\RaiDrive Mount\log
Paste the path into the File Explorer address bar — %ProgramData%
expands to the actual folder (usually C:\ProgramData) even when Windows
is installed on a different drive. The %…% form works in File Explorer
and Command Prompt; in PowerShell use $env:ProgramData instead:
explorer "$env:ProgramData\OpenBoxLab\RaiDrive Mount\log"
Older versions use %ProgramData%\OpenBoxLab\RaiDrive\log. Logs contain
the error details we need to diagnose your case.
Program and data locations¶
| Item | Location |
|---|---|
| Program | under %ProgramFiles%\OpenBoxLab (usually C:\Program Files\OpenBoxLab) |
| Data root | %ProgramData%\OpenBoxLab\RaiDrive Mount (older versions: …\RaiDrive) |
| Logs | …\RaiDrive Mount\log |
| Cache (default) | …\RaiDrive Mount\Cache — changeable in Settings → Cache |
| Settings | stored encrypted under the data root |
Common messages¶
The first seven rows below all appear in the same connection-error dialog — only the body text changes; the buttons are always Retry / Sign In / Cancel.
| Message | Where | Meaning | What to do |
|---|---|---|---|
| "Unable to connect to remote storage. Please check your internet connection…" | Connection dialog | RaiDrive can't reach the storage service | Check the connection, proxy settings, and any firewall |
| "Authorization or authentication failed. Would you like to re-authenticate?" | Connection dialog | The saved sign-in is no longer valid (expired or revoked) | Answer yes and sign in again; if it keeps failing, delete the drive and add it again |
| "Authentication failed. Please check your account (password)." | Connection dialog | Wrong credentials for a NAS or key-based storage | Re-enter the account, password, or access keys |
| "The connection method to the remote storage has changed. You need to sign in again." | Connection dialog | The storage's API or auth method changed with an update | Sign in again on the drive |
| "The download quota has been exceeded. Download restrictions are the policy of …" | Connection dialog | The storage service's own transfer quota is exhausted | Wait for the quota to reset, or upgrade the storage plan |
| "You must change the drive letter or drive name." | Connection dialog | Another drive already uses that letter or name | Pick a different letter or name in the drive's Options |
| "Please check the address." / "Please check the port…" | Connection dialog | A NAS/server connection detail is wrong | Verify address, protocol, and port in the drive's Options |
| Sign-in returns an error (e.g. 400) with correct credentials | — (server response, no fixed text) | The PC's clock is out of sync | Turn on automatic time synchronization in Windows Settings → Time & language |
| "The disk is write protected" | File Explorer, not RaiDrive (Windows' own ERROR_WRITE_PROTECT) |
The drive's Read-only option is on (or the storage needs a write addon) | Uncheck Read-only in the drive's Options — see forum thread |
| Transfers of many small files are slow | — (not a message, a symptom) | Per-file request overhead — normal for cloud storage | Compare with a web-browser upload; transfer archives instead of many small files, or raise the copy tool's parallelism |
| "The cache storage space is almost full. Increase the storage space." | Tray notification | The disk holding the cache is running out of space | See Settings → Cache |
| "Device driver is not installed on your system. You need to reinstall RaiDrive." | Startup dialog (blocks launch) | The file-system driver is missing or broken | Reinstall RaiDrive |
| "RaiDrive is not ready to start. You need to restart the system." | Startup dialog (blocks launch) | The driver needs a reboot to finish setup | Restart Windows |