Skip to main content

Connecting OneDrive

This guide shows you how to connect Microsoft OneDrive (Personal or Business) to Pluton for backup storage.

Prerequisites

  • A Microsoft account with OneDrive access
  • OneDrive Personal, OneDrive for Business, or SharePoint access
  • Modern web browser for OAuth authentication

Connection Process

Step 1: Add Storage

  1. In Pluton, navigate to Storages
  2. Click Add Storage button
  3. Select OneDrive from the provider list

Step 2: Basic Configuration

Enter a friendly name:

  • Storage Name: Descriptive name (e.g., "OneDrive Personal Backups")

Step 3: OAuth Authentication

Pluton uses OAuth2 for secure OneDrive authentication:

  1. Click Authorize with OneDrive button
  2. A browser window will open automatically
  3. Log into your Microsoft account if not already logged in
  4. Review the permissions Pluton requests:
    • Read and write access to your OneDrive files
    • Offline access (to maintain connection)
  5. Click Accept to grant permissions
  6. You'll be redirected back to Pluton automatically

Step 4: Select Drive Type

After authorization, choose your OneDrive type:

OneDrive Personal:

  • Your personal OneDrive storage
  • Typically 5GB-1TB depending on subscription

OneDrive for Business:

  • Work or school OneDrive account
  • Access to your business OneDrive folder

SharePoint Document Library:

  • Access SharePoint sites and document libraries
  • Requires additional site selection

Step 5: Configure Location (Business/SharePoint only)

For OneDrive Business or SharePoint:

  1. Select the drive or site you want to use
  2. Pluton will display available drives/sites
  3. Choose the appropriate location for your backups

Step 6: Advanced Options (Optional)

Additional settings:

  • Region: Select your Microsoft cloud region (Global, US Government, Germany, China)
  • Chunk Size: Leave default (10MB) unless you experience upload issues
  • Hard Delete: Enable to permanently delete files instead of moving to recycle bin

Step 7: Save Configuration

  1. Click Test Connection to verify access
  2. Once successful, click Save
  3. Your OneDrive storage is ready for use

Drive Types Explained

Personal: Your personal OneDrive folder at the root level.

Business: Your work OneDrive folder, separate from team/shared folders.

SharePoint: Access to SharePoint sites and team document libraries. Requires Sites.Read.All permission.

Common Issues

Authorization Failed: Ensure pop-ups are not blocked in your browser. Try again and allow the Microsoft authentication window.

Drive Not Found: For Business accounts, verify you have the correct permissions. Contact your IT administrator if needed.

Sites.Read.All Permission: If you cannot access SharePoint sites, your organization may need to grant additional permissions.

Token Expired: If connection stops working, simply re-authorize through Pluton to refresh the authentication token.

OneDrive Personal vs Business

Personal:

  • Simpler setup process
  • Direct access to personal files
  • Individual storage quota

Business:

  • May require IT admin approval
  • Access to organizational drives
  • Can access Team Folders with leading "/" (e.g., /TeamFolder/path)
  • SharePoint integration available

Best Practices

  • For OneDrive Business, confirm with IT that third-party apps are permitted
  • Regularly verify your connection is active (check backup logs)
  • OneDrive has a maximum file size of 250GB
  • Avoid storing extremely large backup repositories (100,000+ files) in a single folder
  • For Team Folders in Business accounts, use path format: /TeamFolder/subfolder