restic-repair-snapshots(1)

1restic backup(1)                                              restic backup(1)
2
3
4

NAME

6       restic-repair-snapshots - Repair snapshots
7
8
9

SYNOPSIS

11       restic repair snapshots [flags] [snapshot ID] [...]
12
13
14

DESCRIPTION

16       The  "repair  snapshots" command repairs broken snapshots. It scans the
17       given snapshots and generates new ones  with  damaged  directories  and
18       file contents removed. If the broken snapshots are deleted, a prune run
19       will be able to clean up the repository.
20
21
22       The command depends on a correct index, thus make sure to  run  "repair
23       index" first!
24
25
26

WARNING

28       Repairing  and  deleting broken snapshots causes data loss! It will re‐
29       move broken directories and modify broken files in the  modified  snap‐
30       shots.
31
32
33       If  the contents of directories and files are still available, the bet‐
34       ter option is to run "backup" which in that case is able to heal exist‐
35       ing  snapshots.  Only use the "repair snapshots" command if you need to
36       recover an old and broken snapshot!
37
38
39

EXIT STATUS

41       Exit status is 0 if the command was successful, and non-zero  if  there
42       was any error.
43
44
45

OPTIONS

47       -n, --dry-run[=false]      do not do anything, just print what would be
48       done
49
50
51       --forget[=false]      remove original snapshots after creating new ones
52
53
54       -h, --help[=false]      help for snapshots
55
56
57       -H, --host=[]      only consider snapshots for this host (can be speci‐
58       fied multiple times)
59
60
61       --path=[]       only  consider snapshots including this (absolute) path
62       (can be specified multiple times)
63
64
65       --tag=[]      only consider snapshots including tag[,tag,...]  (can  be
66       specified multiple times)
67
68
69

OPTIONS INHERITED FROM PARENT COMMANDS

71       --cacert=[]      file to load root certificates from (default: use sys‐
72       tem certificates or $RESTIC_CACERT)
73
74
75       --cache-dir=""      set the cache directory. (default: use  system  de‐
76       fault cache directory)
77
78
79       --cleanup-cache[=false]      auto remove old cache directories
80
81
82       --compression=auto      compression mode (only available for repository
83       format version 2), one of (auto|off|max) (default: $RESTIC_COMPRESSION)
84
85
86       --insecure-tls[=false]      skip TLS certificate verification when con‐
87       necting to the repository (insecure)
88
89
90       --json[=false]       set  output mode to JSON for commands that support
91       it
92
93
94       --key-hint=""      key ID of key  to  try  decrypting  first  (default:
95       $RESTIC_KEY_HINT)
96
97
98       --limit-download=0       limits  downloads  to a maximum rate in KiB/s.
99       (default: unlimited)
100
101
102       --limit-upload=0      limits uploads to a maximum rate in  KiB/s.  (de‐
103       fault: unlimited)
104
105
106       --no-cache[=false]      do not use a local cache
107
108
109       --no-lock[=false]      do not lock the repository, this allows some op‐
110       erations on read-only repositories
111
112
113       -o, --option=[]      set extended option (key=value, can  be  specified
114       multiple times)
115
116
117       --pack-size=0       set target pack size in MiB, created pack files may
118       be larger (default: $RESTIC_PACK_SIZE)
119
120
121       --password-command=""      shell command to obtain the repository pass‐
122       word from (default: $RESTIC_PASSWORD_COMMAND)
123
124
125       -p,  --password-file=""       file to read the repository password from
126       (default: $RESTIC_PASSWORD_FILE)
127
128
129       -q, --quiet[=false]      do not output comprehensive progress report
130
131
132       -r, --repo=""      repository to backup to or  restore  from  (default:
133       $RESTIC_REPOSITORY)
134
135
136       --repository-file=""       file  to  read  the repository location from
137       (default: $RESTIC_REPOSITORY_FILE)
138
139
140       --retry-lock=0s      retry to lock the  repository  if  it  is  already
141       locked, takes a value like 5m or 2h (default: no retries)
142
143
144       --tls-client-cert=""       path  to  a  file containing PEM encoded TLS
145       client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
146
147
148       -v, --verbose[=0]      be verbose (specify multiple times  or  a  level
149       using --verbose=n``, max level/times is 2)
150
151
152