restic-tag(1)

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

NAME

6       restic-tag - Modify tags on snapshots
7
8
9

SYNOPSIS

11       restic tag [flags] [snapshot-ID ...]
12
13
14

DESCRIPTION

16       The "tag" command allows you to modify tags on exiting snapshots.
17
18
19       You can either set/replace the entire set of tags on a snapshot, or add
20       tags to/remove tags from the existing set.
21
22
23       When no snapshot-ID is given, all snapshots matching the host, tag  and
24       path filter criteria are modified.
25
26
27

EXIT STATUS

29       Exit  status  is 0 if the command was successful, and non-zero if there
30       was any error.
31
32
33

OPTIONS

35       --add=[]      tags which will be added to the existing tags in the for‐
36       mat tag[,tag,...] (can be given multiple times)
37
38
39       -h, --help[=false]      help for tag
40
41
42       -H, --host=[]      only consider snapshots for this host, when no snap‐
43       shot ID is given (can be specified multiple times)
44
45
46       --path=[]      only consider snapshots which  include  this  (absolute)
47       path, when no snapshot-ID is given
48
49
50       --remove=[]       tags  which will be removed from the existing tags in
51       the format tag[,tag,...] (can be given multiple times)
52
53
54       --set=[]      tags which will replace the existing tags in  the  format
55       tag[,tag,...] (can be given multiple times)
56
57
58       --tag=[]       only consider snapshots which include this taglist, when
59       no snapshot-ID is given
60
61
62

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO