OneDrive

OneDrive is a widely used cloud storage service provided by Microsoft, offering users the ability to store files, share documents, and collaborate in real time.

Rclone is a command-line program to manage files on cloud storage, and supports OneDrive as one of its many backends.

The Rclone integration package for Plakar provides three connectors:

Requirements

• Rclone must be installed, and at least one OneDrive remote must be configured.

Typical use cases

• Cold backup of OneDrive folders
• Long-term archiving and disaster recovery
• Portable export and vendor escape to other platforms

To interact with OneDrive, you need to install the Rclone Plakar package.

$ plakar pkg add rclone

$ plakar pkg list

$ plakar pkg build rclone

$ plakar pkg add ./rclone_v1.0.0_darwin_arm64.ptar

$ plakar pkg list

To list, upgrade, or remove the package, see managing packages guide.

Install Rclone on your system by following the instructions at https://rclone.org/install/.

Then, run the following command to configure Rclone with OneDrive:

$ rclone config

You will be guided through a series of prompts to set up a new remote for OneDrive.

For Rclone v1.72.1, the configuration flow is as follows:

1. Choose n to create a new remote.
2. Name the remote (e.g., mydrive).
3. Enter the number corresponding to “Microsoft OneDrive” from the list of supported storage providers.
4. Leave client_id and client_secret empty to use Rclone’s defaults, or provide your own if you have them.
5. Select your region (usually “Microsoft Cloud Global”).
6. Enter service principal’s tenant ID if applicable, or leave empty.
7. Stay with the current settings, and do not edit advanced config.
8. Choose to open the browser for authentication.
9. Once validated, select the type of connection.
10. Select the drive to use.
11. Validate the remote configuration.

To verify that the remote is configured, run:

$ rclone config show mydrive

And to verify you have access to your OneDrive files, run:

$ rclone ls mydrive:

The output should list the files and folders in your OneDrive.

The Rclone package provides storage, source, and destination connectors to interact with OneDrive via Rclone.

You can use any combination of these connectors together with other supported Plakar connectors.

The Plakar Rclone package provides a storage connector to host Kloset stores on Rclone remotes.

flowchart LR

Source["Source data"]

Plakar["Plakar"]

Via["Store snapshot via
Rclone storage connector"]

subgraph Store["Rclone Remote"]
  Kloset["Kloset Store"]
end

Source --> Plakar --> Via --> Kloset

# Import the rclone configuration as a storage configuration.
# Replace "mydrive" with your Rclone remote name.
$ rclone config show | plakar store import -rclone mydrive

# Initialize the Kloset store
$ plakar at "@mydrive" create

# List snapshots in the Kloset store
$ plakar at "@mydrive" ls

# Verify integrity of the Kloset store
$ plakar at "@mydrive" check

# Back up a local folder to the Kloset store
$ plakar at "@mydrive" backup /etc

# Back up a source configured in Plakar to the Kloset store
$ plakar at "@mydrive" backup "@my_source"

These options can be set when configuring the storage connector with plakar store add or plakar store set:

The Plakar Rclone package provides a source connector to back up remote directories accessible via Rclone.

flowchart LR

subgraph Source["Rclone Remote"]
  FS["Data"]
end

Plakar["Plakar"]

Via["Retrieve data via
Rclone source connector"]

Store["Kloset Store"]

FS --> Via --> Plakar --> Store

# Import the rclone configuration as a source configuration.
# Replace "mydrive" with your Rclone remote name.
$ rclone config show | plakar source import -rclone mydrive

# Back up the remote directory to the Kloset store on the filesystem
$ plakar at /var/backups backup "@mydrive"

# Or back up the remote directory to a Kloset store configured with "plakar store add"
$ plakar at "@store" backup "@mydrive"

The Rclone source connector doesn’t support any specific options.

The Rclone package provides a destination connector to restore snapshots to remote directories reachable over Rclone.

flowchart LR

Store["Kloset Store"]

Plakar["Plakar"]

Via["Push data via
Rclone destination connector"]

subgraph Destination["Rclone Remote"]
  FS["Data"]
end

Store --> Plakar --> Via --> FS

# Import the rclone configuration as a destination configuration.
# Replace "mydrive" with your Rclone remote name.
$ rclone config show | plakar destination import -rclone mydrive

# Restore a snapshot from a filesystem-hosted Kloset store to the Rclone remote
$ plakar at /var/backups restore -to "@mydrive" <snapshot_id>

# Or restore a snapshot from the Kloset store configured with "plakar store add store …"
$ plakar at "@store" restore -to "@mydrive" <snapshot_id>

The Rclone destination connector doesn’t support any specific options.

• OneDrive API has rate limits, heavy usage may require throttling.
• File version history is not preserved. Only the current version of each file is snapshotted.
• Shared links and permissions are not preserved in snapshots.

• Rclone documentation for OneDrive