onedrive Code 0x8004de90

How to Fix OneDrive Error 0x8004de90

Diagnostic Procedures

  • 1 Understand the meaning of OneDrive error 0x8004de90
  • 2 Trigger and complete the initial OneDrive setup wizard
  • 3 Verify Office 365 licensing and OneDrive provisioning
  • 4 Clear local OneDrive cache and run a client reset
  • 5 Resolve multi-account and tenant directory sync conflicts

How to Fix OneDrive Error 0x8004de90

If you are seeing OneDrive Error Code 0x8004de90, it means the OneDrive desktop client has not been fully initialized or set up. This error commonly appears when the sync client fails to find an active configuration database or when there is a provisioning delay with a work or school account.

This detailed guide explains the root causes of the 0x8004de90 error and provides steps to resolve it on Windows and macOS.

What Causes OneDrive Error 0x8004de90?

Error 0x8004de90 translates to “OneDrive is not set up.” The primary causes include:

  1. Uncompleted Sync Setup: The OneDrive application is installed, but the user has not completed the sign-in wizard to bind a folder to their account.
  2. Account Provisioning Delay: For new Microsoft 365 Enterprise, Work, or School accounts, the administrator has assigned the license, but the backend SharePoint/OneDrive library has not yet been provisioned.
  3. Corrupted Registry Key Associations: The local registry values that tell OneDrive which directories to sync have been modified or deleted.
  4. Incorrect Account Binding: Trying to log in with an unsupported personal Microsoft account on a client pre-configured strictly for corporate tenant groups.

Detailed Steps to Resolve Error 0x8004de90

Platform-Specific Steps for Windows Users

Method 1: Manually Force-Start the Setup Wizard

Sometimes the background daemon is running but failed to display the user configuration window.

  1. Press Windows Key + R to open the Run dialog.
  2. Copy and run the following command: 
    %localappdata%\Microsoft\OneDrive\onedrive.exe
  3. If the setup wizard pops up, enter your email address and complete the login sequence.

Method 2: Reset the OneDrive App and Account Bindings

If the client is stuck in an initialization loop, resetting it will purge corrupt configurations and prompt for a fresh setup.

  1. Open Command Prompt as Administrator.
  2. Run the following command: 
    %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  3. After 2 minutes, relaunch the application manually: 
    %localappdata%\Microsoft\OneDrive\onedrive.exe

Method 3: Clear the Registry Account Entries

If the local database and registry are out of sync, deleting the accounts registry branch forces OneDrive to rebuild its environment.

  1. Open Command Prompt as Administrator.
  2. Run this command to delete the local accounts key: 
    reg delete "HKCU\Software\Microsoft\OneDrive\Accounts" /f
  3. Relaunch OneDrive to start the wizard.

Platform-Specific Steps for macOS Users

Method 1: Clear the Mac Application Sandboxed Containers

On macOS, cached account structures are saved within sandboxed app containers. Removing these forces the setup wizard to trigger.

  1. Open Terminal (located in /Applications/Utilities/).
  2. Run the following commands to delete the OneDrive configuration profile: 
    killall OneDrive
defaults delete com.microsoft.OneDrive-mac
rm -rf ~/Library/Containers/com.microsoft.OneDrive-mac
rm -rf ~/Library/Group\ Containers/UBF8T346G9.OneDriveStandaloneSuite
  3. Open OneDrive from your Applications folder.

Method 2: Verify Web Provisioning Status (For Work/School Accounts)

If the account is new, verify that the backend is fully provisioned.

  1. Open a web browser and go to portal.office.com.
  2. Log in with your corporate credentials.
  3. Click on the OneDrive icon.
  4. If you see a page that says “We’re setting up your OneDrive,” you must wait for Microsoft to finish provisioning the storage backend (this can take up to 24 hours for new tenants). Once the files page displays in the browser, relaunch the desktop client and sign in.

Summary Checklist for Quick Reference

  • Opened the OneDrive application manually to check if the setup wizard initiates.
  • Logged into the Office 365 web portal to verify if OneDrive is provisioned.
  • Deleted the OneDrive registry key (HKCU\Software\Microsoft\OneDrive\Accounts) on Windows.
  • Reset macOS settings container directories via terminal.
  • Verified that a valid SharePoint/OneDrive license is assigned to the account.