transfer

Here's the command-line help for this action in the most recent version of borgmatic. If you're using an older version, some of these flags may not work, and you should instead run the action with --help to see the flags specific to your borgmatic version.

usage: borgmatic transfer [--repository REPOSITORY] --source-repository
                          SOURCE_REPOSITORY [--archive ARCHIVE]
                          [--upgrader UPGRADER] [--progress] [-a PATTERN]
                          [--sort-by KEYS] [--first N] [--last N]
                          [--oldest TIMESPAN] [--newest TIMESPAN]
                          [--older TIMESPAN] [--newer TIMESPAN] [-h]

Transfer archives from one repository to another, optionally upgrading the
transferred data [Borg 2.0+ only]

transfer arguments:
  --repository REPOSITORY
                        Path of existing destination repository to transfer
                        archives to, defaults to the configured repository if
                        there is only one, quoted globs supported
  --source-repository SOURCE_REPOSITORY
                        Path of existing source repository to transfer
                        archives from
  --archive ARCHIVE     Name or hash of a single archive to transfer (or
                        "latest"), defaults to transferring all archives
  --upgrader UPGRADER   Upgrader type used to convert the transferred data,
                        e.g. "From12To20" to upgrade data from Borg 1.2 to 2.0
                        format, defaults to no conversion
  --progress            Display progress as each archive is transferred
  -a PATTERN, --match-archives PATTERN, --glob-archives PATTERN
                        Only transfer archives with names, hashes, or series
                        matching this pattern
  --sort-by KEYS        Comma-separated list of sorting keys
  --first N             Only transfer first N archives after other filters are
                        applied
  --last N              Only transfer last N archives after other filters are
                        applied
  --oldest TIMESPAN     Transfer archives within a specified time range
                        starting from the timestamp of the oldest archive
                        (e.g. 7d or 12m) [Borg 2.x+ only]
  --newest TIMESPAN     Transfer archives within a time range that ends at
                        timestamp of the newest archive and starts a specified
                        time range ago (e.g. 7d or 12m) [Borg 2.x+ only]
  --older TIMESPAN      Transfer archives that are older than the specified
                        time range (e.g. 7d or 12m) from the current time
                        [Borg 2.x+ only]
  --newer TIMESPAN      Transfer archives that are newer than the specified
                        time range (e.g. 7d or 12m) from the current time
                        [Borg 2.x+ only]
  -h, --help            Show this help message and exit

Related documentation

• Upgrade Borg 1.2 to 2.0