borg-upgrade(1)                borg backup tool                borg-upgrade(1)

<?><?><?> (NAME)
       borg-upgrade - <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       borg [<?><?><?><?><?><?><?><?><?> <?><?><?><?><?>] upgrade
       [<?><?><?><?><?><?><?><?>] [REPOSITORY]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
       Borg.

   <?><?> <?><?><?><?><?> <?><?> borg upgrade <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> borg
       upgrade <?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>:

       o <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
         <?><?><?><?>

       o <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
         (<?><?><?><?><?> 1.0.x <?><?> 1.0.y)<?> <?><?><?> <?><?><?><?><?>
         <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
         <?><?><?> <?><?><?> <?><?><?><?>

       o <?><?><?><?><?> <?><?> 1.0.x <?><?> 1.1.x<?> <?><?><?>
         <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
         <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?>

   <?><?><?><?><?><?><?><?> Borg 1.x.y
       <?><?><?><?><?> <?><?><?><?><?> TAM <?><?><?><?><?>:

       <?><?> <?><?><?><?><?> borg upgrade --archives-tam REPO <?><?><?><?>
       <?><?><?><?><?><?> TAM <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> TAM
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> - <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> TAM
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> TAM <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> borg <?><?><?> <?><?> 1.0.9 <?><?><?><?><?> TAM
       <?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> borg
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> TAM
       <?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> (<?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>).
       <?><?><?><?> Borg 1.2.5 <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> TAM
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?> TAM <?><?><?><?><?><?><?>:

       <?><?> <?><?><?><?><?> borg upgrade --tam REPO <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> Borg 1.0.9 <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?> 1.0.9 <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?><?> 1.0.9 <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?> 1.0.9 <?><?><?><?><?><?><?> <?><?><?>
       <?><?> borg upgrade --tam --force REPO <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> (<?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>). <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> borg upgrade --disable-tam REPO <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:
       <https://borgbackup.readthedocs.io/en/stable/changes.html#
       pre-1-0-9-manifest-spoofing-vulnerability>

   Attic <?> Borg 0.xx <?><?> Borg 1.x
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> Attic <?><?> Borg <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> Borg
       0.xx <?><?> 1.0 <?><?><?><?> <?><?><?><?><?><?><?><?>.

       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> (LOCAL) <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       (<?><?><?><?> #465).

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       borg create (<?><?> <?><?><?><?> 1.0.0) <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> (chunks)
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> borg <?><?> attic <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (deduplicate)
       <?><?><?><?><?><?><?> <?><?>.  <?><?><?><?><?> --chunker-params <?><?>
       <?><?><?><?><?><?><?> borg create <?> borg recreate <?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?> borg upgrade <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (magic strings) <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> Borg <?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       $ATTIC_KEYS_DIR <?><?> ~/.attic/keys/ <?><?><?> <?><?><?><?><?>
       <?><?><?> <?> <?><?> $BORG_KEYS_DIR <?><?> ~/.config/borg/keys
       <?><?><?> <?><?><?><?><?><?> <?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> $ATTIC_CACHE_DIR <?><?>
       ~/.cache/attic <?><?> $BORG_CACHE_DIR <?><?> ~/.cache/borg
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> Borg <?> Attic <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> borg delete <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>:

          borg delete borg

       <?><?><?> <?><?> <?><?><?><?><?> <?><?> --inplace <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> (hardlinks) <?><?>
       REPOSITORY.before-upgrade-DATETIME <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?>.  <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?> cp -al). <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>.

       <?><?><?><?><?>: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> (in-place) <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?>! <?><?><?><?><?><?><?><?><?> Attic
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> BORG <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> Borg <?><?> borg-common(1) <?><?><?><?><?><?>
       <?><?><?><?>.

   <?><?><?><?><?><?><?><?><?><?> (ARGUMENTS)

       REPOSITORY
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>

   <?><?><?><?><?><?><?><?> (OPTIONS)

       -n, --dry-run
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>

       --inplace
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.

       --force
              <?><?><?><?><?><?> <?><?><?><?><?><?>

       --tam  <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?> <?><?><?><?> <?> <?><?><?>) (Borg
              1.0.9 <?> <?><?><?><?><?><?>).

       --check-tam
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?> <?><?><?><?> <?> <?><?><?>).

       --disable-tam
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?> <?><?><?><?> <?>
              <?><?><?>).

       --check-archives-tam
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> TAM <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?>.

       --archives-tam
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> TAM
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)

          # <?><?><?><?><?><?> <?><?><?><?> borg <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>.
          $ borg upgrade -v /path/to/repo
          making a hardlink copy in /path/to/repo.before-upgrade-2016-02-15-20:51:55
          opening attic repository with borg and converting
          no key file found for repository
          converting repo index /path/to/repo/index.0
          converting 1 segments...
          converting borg 0.xx to borg current
          no key file found for repository

   <?><?><?><?><?><?> <?><?><?><?> Attic <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> passphrase
       <?><?><?><?><?><?><?><?><?> Attic <?><?><?><?> <?><?><?><?><?><?><?><?>
       "passphrase" <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?> Borg 1.0 <?><?><?> <?><?> <?> <?><?>
       <?><?><?><?> "repokey" <?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>).

       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> "passphrase" <?><?><?><?><?><?><?><?><?> Attic <?><?>
       <?><?><?><?> "repokey" <?><?> Borg<?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>:

       o borg upgrade repo

       o borg key migrate-to-repokey repo

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       borg-common(1)

<?><?><?><?><?><?><?> (AUTHOR)
       The Borg Collective

                                  2026-07-18                   borg-upgrade(1)