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​

Connection Process​

Method 1: Quick Connect (Using Rclone Client)​

Step 1: Add Storage​

  1. In Pluton, navigate to Storages
  2. Click Add Storage button
  3. Select One Drive from the provider list
  4. Set a Storage name. (e.g., "My One Drive")

Step 2: Acquire Access Token​

Acquiring Access Token on Desktop Installations​

  1. From the Authentication Section, select User (oAuth)
  2. If you've installed Pluton on a desktop machine, simply click the Authorize & Get Access Token button.
  3. When a new browser tab opens asking you to authorize the Rclone connection, accept it.
  4. Once authorized, you will be returned to a Success screen in the same tab. Close the tab as its not needed anymore.
  5. Go back to Pluton, and the OAuth Access Token should be automatically filled.

Acquiring Access Token on Server/Docker Installations​

Since Pluton installed on servers that may not have a web browser, you need to generate an OAuth token using rclone authorize on a machine that does have a browser:

  1. Install rclone on a machine with a web browser
  2. Run the following command: 
    rclone authorize drive
  3. A browser window will open — log in with your One Drive account and grant access
  4. Once authorized, rclone will print a JSON token blob to the terminal which should looks something like this 
       Paste the following into your remote machine --->
       {"access_token":"VWFL7ZDnONSzyJXpmZ6EiR5kZvWXNeprInuuCap7pW7jwzH65aGak","token_type":"bearer","expiry":"0001-01-01T00:00:00Z"}
       <---End paste
  5. Copy the entire JSON token between the ---> and <---
  6. Go back to Pluton, and insert the copied token in the OAuth Access Token field.

Step 3: Complete the Storage Setup​

  1. Click the Add Storage button which automatically verifies credentials and adds the storage.
  2. Your One Drive storage is now ready for backup plans

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

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