Tip: Generating missing/corrupted blobs

General Topics
1

If you happen to delete a folder or file (blob) by accident from a repo, or a network sync failure (rclone backend bug / VFS / FUSE / bad drive), backup your repo first then follow these steps to regenerate them:

  1. kopia snapshot fix invalid-files --commit
  2. kopia cache clear
  3. kopia maintenance run --full --safety=none
  4. kopia snapshot create

In case you get unable to rewrite content "BLOB not found" remove empty folders and rerun the commands.

Note that if the source no longer contains the file that was covered by the missing blob tied to any snapshot, it will show up as .INVALID.yourfilenamehere on restore with the following content inside:

{
      "info": "Kopia replaced the original entry with this stub because of an error.",
      "error": "object Ix99721bde8c77aedf619ff6689bd65138 is backed by missing blob p10cda0a4e1ba3bdf8b02258abbb90290-s45dbf2dde6c6b02c13d",
      "entry": {
          "name": "yourfilenamehere.mp4",
          "type": "f",
          "mode": "0666",
          "size": 8405570,
          "mtime": "2026-01-13T06:17:43.6489384Z",
          "obj": "Ix99721bde8c77aedf619ff6689bd65138"
      }
  }

To be extra safe assuming that there is no egress cost, test repo restore functionality after clearing cache.

I :heart: Kopia.

Relevant topics
2 Likes