diff --git a/docs/tutorials/integrations/onedrive-sharepoint.mdx b/docs/tutorials/integrations/onedrive-sharepoint.mdx index 9a20bdbc..7a5a10b2 100644 --- a/docs/tutorials/integrations/onedrive-sharepoint.mdx +++ b/docs/tutorials/integrations/onedrive-sharepoint.mdx @@ -5,7 +5,7 @@ title: "Integrate with OneDrive & SharePoint" :::info -This tutorial provides a step-by-step guide for integrating Open WebUI with **Microsoft OneDrive for Business & SharePoint**, as well as the separate, optional integration for **Personal Microsoft OneDrive** accounts. You can enable one or both integrations. This documentation is up to date as of Open WebUI v0.6.32. +This tutorial provides a step-by-step guide for integrating Open WebUI with **Microsoft OneDrive for Business & SharePoint**, as well as the separate, optional integration for **Personal Microsoft OneDrive** accounts. You can enable one or both integrations. This documentation is up to date as of Open WebUI v0.6.37. ::: @@ -133,9 +133,25 @@ ONEDRIVE_CLIENT_ID_PERSONAL="zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz" --- -## Final Step: Browser Configuration and Verification +## Final Step: Enable OneDrive Integration in Admin Settings -After setting your environment variables and restarting your Open WebUI instance, verify the integration. +After setting your environment variables and restarting your Open WebUI instance, you must explicitly enable the feature in the admin panel. **The environment variables alone do not activate the integration.** + +1. Navigate to **Settings → Admin → Documents**. +2. Toggle on the **"OneDrive"** switch. +3. Refresh your browser or log out and log back in. + +:::warning + +Admin Toggle is Required + +This step is mandatory even though you've set `ENABLE_ONEDRIVE_INTEGRATION=true` in your environment. Some configuration options in Open WebUI are persistent database settings that are initialized on first startup but must be activated through the admin interface. + +::: + +## Verifying the Integration + +After enabling the admin toggle and refreshing, verify the integration is working: 1. In Open WebUI, open the attachment menu (+) in the chat input. You should see menu items for **"Microsoft OneDrive (work/school)"** and/or **"Microsoft OneDrive (personal)"**, depending on your configuration. 2. Clicking either option should trigger a pop-up window for Microsoft authentication. @@ -143,8 +159,27 @@ After setting your environment variables and restarting your Open WebUI instance :::caution Disable Pop-up Blockers! -The OneDrive file picker and authentication flow happen in a pop-up window. If nothing happens when you click a OneDrive option, it is almost certainly because your browser is blocking pop-ups. **You must disable the pop-up blocker for your Open WebUI domain** for the integration to work. + +The OneDrive file picker and authentication flow happen in a pop-up window. If nothing happens when you click a OneDrive option, your browser is almost certainly blocking pop-ups. **You must disable the pop-up blocker for your Open WebUI domain** for the integration to work. Note that some browsers (like Chrome) may have additional restrictions compared to others (like Edge). ::: +## Troubleshooting + +**OneDrive option not appearing in the attachment menu:** +- Verify the admin toggle is enabled in Settings → Admin → Documents +- Refresh your browser after enabling the toggle +- Check that your environment variables are correctly set and the container has been restarted + +**Files not loading or folders not clickable:** +- Log out of Open WebUI completely and log back in to refresh your authentication tokens +- Verify the Azure App Registration permissions are correctly configured and admin consent is granted +- Check browser console for any authentication errors + +**Authentication pop-up not appearing:** +- Disable pop-up blockers for your Open WebUI domain +- Try a different browser (Edge tends to work more reliably than Chrome for Microsoft authentication flows) + +--- + You have now successfully configured OneDrive integration, providing seamless file access for your users.