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

NAME

6       restic-forget - Remove snapshots from the repository
7
8
9

SYNOPSIS

11       restic forget [flags] [snapshot ID] [...]
12
13
14

DESCRIPTION

16       The "forget" command removes snapshots according to a policy. Please
17       note that this command really only deletes the snapshot object in the
18       repository, which is a reference to data stored there. In order to
19       remove this (now unreferenced) data after 'forget' was run
20       successfully, see the 'prune' command.
21
22
23

OPTIONS

25       -l, --keep-last=0
26           keep the last n snapshots
27
28
29       -H, --keep-hourly=0
30           keep the last n hourly snapshots
31
32
33       -d, --keep-daily=0
34           keep the last n daily snapshots
35
36
37       -w, --keep-weekly=0
38           keep the last n weekly snapshots
39
40
41       -m, --keep-monthly=0
42           keep the last n monthly snapshots
43
44
45       -y, --keep-yearly=0
46           keep the last n yearly snapshots
47
48
49       --keep-within=
50           keep snapshots that are newer than duration (eg. 1y5m7d2h) relative
51       to the latest snapshot
52
53
54       --keep-tag=[]
55           keep snapshots with this taglist (can be specified multiple times)
56
57
58       --host=""
59           only consider snapshots with the given host
60
61
62       --tag=[]
63           only consider snapshots which include this taglist in the format
64       tag[,tag,...] (can be specified multiple times)
65
66
67       --path=[]
68           only consider snapshots which include this (absolute) path (can be
69       specified multiple times)
70
71
72       -c, --compact[=false]
73           use compact format
74
75
76       -g, --group-by="host,paths"
77           string for grouping snapshots by host,paths,tags
78
79
80       -n, --dry-run[=false]
81           do not delete anything, just print what would be done
82
83
84       --prune[=false]
85           automatically run the 'prune' command if snapshots have been
86       removed
87
88
89       -h, --help[=false]
90           help for forget
91
92
93

OPTIONS INHERITED FROM PARENT COMMANDS

95       --cacert=[]
96           file to load root certificates from (default: use system
97       certificates)
98
99
100       --cache-dir=""
101           set the cache directory. (default: use system default cache
102       directory)
103
104
105       --cleanup-cache[=false]
106           auto remove old cache directories
107
108
109       --json[=false]
110           set output mode to JSON for commands that support it
111
112
113       --key-hint=""
114           key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
115
116
117       --limit-download=0
118           limits downloads to a maximum rate in KiB/s. (default: unlimited)
119
120
121       --limit-upload=0
122           limits uploads to a maximum rate in KiB/s. (default: unlimited)
123
124
125       --no-cache[=false]
126           do not use a local cache
127
128
129       --no-lock[=false]
130           do not lock the repo, this allows some operations on read-only
131       repos
132
133
134       -o, --option=[]
135           set extended option (key=value, can be specified multiple times)
136
137
138       --password-command=""
139           specify a shell command to obtain a password (default:
140       $RESTIC_PASSWORD_COMMAND)
141
142
143       -p, --password-file=""
144           read the repository password from a file (default:
145       $RESTIC_PASSWORD_FILE)
146
147
148       -q, --quiet[=false]
149           do not output comprehensive progress report
150
151
152       -r, --repo=""
153           repository to backup to or restore from (default:
154       $RESTIC_REPOSITORY)
155
156
157       --tls-client-cert=""
158           path to a file containing PEM encoded TLS client certificate and
159       private key
160
161
162       -v, --verbose[=0]
163           be verbose (specify --verbose multiple times or level n)
164
165
166

SEE ALSO

168       restic(1)
169
170
171
172generated by `restic generate`     Jan 2017                   restic backup(1)