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] [snapshotID ...]
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 snapshotID 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 (can be speci‐
43       fied multiple times)
44
45
46       --path=[]      only consider snapshots including this  (absolute)  path
47       (can be specified multiple times)
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 including tag[,tag,...] (can be
59       specified multiple times)
60
61
62

OPTIONS INHERITED FROM PARENT COMMANDS

64       --cacert=[]      file to load root certificates from (default: use sys‐
65       tem certificates or $RESTIC_CACERT)
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) (default: $RESTIC_COMPRESSION)
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       --retry-lock=0s       retry  to  lock  the  repository if it is already
134       locked, takes a value like 5m or 2h (default: no retries)
135
136
137       --tls-client-cert=""      path to a file  containing  PEM  encoded  TLS
138       client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT)
139
140
141       -v,  --verbose[=0]       be  verbose (specify multiple times or a level
142       using --verbose=n``, max level/times is 2)
143
144
145

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO