1restic backup(1) restic backup(1)
2
6 restic-rewrite - Rewrite snapshots to exclude unwanted files
7
11 restic rewrite [flags] [snapshotID ...]
12
16 The "rewrite" command excludes files from existing snapshots. It cre‐
17 ates new snapshots containing the same data as the original ones, but
18 without the files you specify to exclude. All metadata (time, host,
19 tags) will be preserved.
20 The snapshots to rewrite are specified using the --host, --tag and
23 --path options, or by providing a list of snapshot IDs. Please note
24 that specifying neither any of these options nor a snapshot ID will
25 cause the command to rewrite all snapshots.
26 The special tag 'rewrite' will be added to the new snapshots to distin‐
29 guish them from the original ones, unless --forget is used. If the
30 --forget option is used, the original snapshots will instead be di‐
31 rectly removed from the repository.
32 Please note that the --forget option only removes the snapshots and not
35 the actual data stored in the repository. In order to delete the no
36 longer referenced data, use the "prune" command.
37
41 Exit status is 0 if the command was successful, and non-zero if there
42 was any error.
43
47 -n, --dry-run[=false] do not do anything, just print what would be
48 done
49 -e, --exclude=[] exclude a pattern (can be specified multiple
52 times)
53 --exclude-file=[] read exclude patterns from a file (can be speci‐
56 fied multiple times)
57 --forget[=false] remove original snapshots after creating new ones
60 -h, --help[=false] help for rewrite
63 -H, --host=[] only consider snapshots for this host (can be speci‐
66 fied multiple times)
67 --iexclude=[] same as --exclude pattern but ignores the casing of
70 filenames
71 --iexclude-file=[] same as --exclude-file but ignores casing of
74 filenames in patterns
75 --path=[] only consider snapshots including this (absolute) path
78 (can be specified multiple times)
79 --tag=[] only consider snapshots including tag[,tag,...] (can be
82 specified multiple times)
83
87 --cacert=[] file to load root certificates from (default: use sys‐
88 tem certificates)
89 --cache-dir="" set the cache directory. (default: use system de‐
92 fault cache directory)
93 --cleanup-cache[=false] auto remove old cache directories
96 --compression=auto compression mode (only available for repository
99 format version 2), one of (auto|off|max)
100 --insecure-tls[=false] skip TLS certificate verification when con‐
103 necting to the repository (insecure)
104 --json[=false] set output mode to JSON for commands that support
107 it
108 --key-hint="" key ID of key to try decrypting first (default:
111 $RESTIC_KEY_HINT)
112 --limit-download=0 limits downloads to a maximum rate in KiB/s.
115 (default: unlimited)
116 --limit-upload=0 limits uploads to a maximum rate in KiB/s. (de‐
119 fault: unlimited)
120 --no-cache[=false] do not use a local cache
123 --no-lock[=false] do not lock the repository, this allows some op‐
126 erations on read-only repositories
127 -o, --option=[] set extended option (key=value, can be specified
130 multiple times)
131 --pack-size=0 set target pack size in MiB, created pack files may
134 be larger (default: $RESTIC_PACK_SIZE)
135 --password-command="" shell command to obtain the repository pass‐
138 word from (default: $RESTIC_PASSWORD_COMMAND)
139 -p, --password-file="" file to read the repository password from
142 (default: $RESTIC_PASSWORD_FILE)
143 -q, --quiet[=false] do not output comprehensive progress report
146 -r, --repo="" repository to backup to or restore from (default:
149 $RESTIC_REPOSITORY)
150 --repository-file="" file to read the repository location from
153 (default: $RESTIC_REPOSITORY_FILE)
154 --tls-client-cert="" path to a file containing PEM encoded TLS
157 client certificate and private key
158 -v, --verbose[=0] be verbose (specify multiple times or a level
161 using --verbose=n``, max level/times is 2)
162
166 restic(1)
167generated by restic generate Jan 2017 restic backup(1)