OpenDrive

The OpenDrive integration backs up OpenDrive folders into a Kloset store, restores snapshots to OpenDrive, and hosts Kloset stores in OpenDrive. It is provided by the Rclone package and reaches OpenDrive through Rclone, a command-line program that manages files on cloud storage and supports OpenDrive as one of its backends.

The integration includes three connectors:

Requirements

• Rclone installed, with at least one OpenDrive remote configured.

Typical use cases

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

Installation

The OpenDrive integration is provided by the Rclone Plakar package.

$ plakar pkg add rclone

$ plakar pkg show

$ plakar pkg build rclone

$ plakar pkg add -allow-unsigned ./rclone_v1.0.0_darwin_arm64.ptar

$ plakar pkg show

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

Configuring an OpenDrive remote

The connectors reach OpenDrive through a Rclone remote. The remote is created with Rclone and then imported into Plakar as a source, destination or store configuration.

Install Rclone by following the instructions at https://rclone.org/install/, then start the interactive configuration:

$ rclone config

The command prompts for the settings of a new OpenDrive remote. 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 your username (your OpenDrive email).
4. Enter your password.
5. Confirm the settings.

Verify that the remote is configured:

$ rclone config show mydrive

Verify access to your OpenDrive files:

$ rclone ls mydrive:

The output lists the files and folders in your OpenDrive.

Configuration

Each connector is configured by importing the Rclone remote with rclone config show | plakar <source|destination|store> import -rclone <remote>. The imported configuration takes the name of the remote, so a remote named mydrive is referenced as @mydrive. The connectors can be combined with any other Plakar connector.

Backup flow

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

Restore flow

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

Store flow

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

Source configuration

The source connector has no options beyond the imported Rclone remote.

Destination configuration

The destination connector has no options beyond the imported Rclone remote.

Store configuration

The following option can be set on the store connector with plakar store add or plakar store set.

Example

Back up the remote:

# 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"

Restore a snapshot to the remote:

# 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>

Host a Kloset store in the remote:

# 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"

See also

• Rclone documentation for OpenDrive
• Managing packages