restic-snapshots(1)

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

NAME

6       restic-snapshots - List all snapshots
7
8
9

SYNOPSIS

11       restic snapshots [flags] [snapshotID ...]
12
13
14

DESCRIPTION

16       The "snapshots" command lists all snapshots stored in the repository.
17
18
19

EXIT STATUS

21       Exit  status  is 0 if the command was successful, and non-zero if there
22       was any error.
23
24
25

OPTIONS

27       -c, --compact[=false]      use compact output format
28
29
30       -g, --group-by=      group snapshots by host, paths and/or tags,  sepa‐
31       rated by comma
32
33
34       -h, --help[=false]      help for snapshots
35
36
37       -H, --host=[]      only consider snapshots for this host (can be speci‐
38       fied multiple times)
39
40
41       --latest=0      only show the last n snapshots for each host and path
42
43
44       --path=[]      only consider snapshots including this  (absolute)  path
45       (can be specified multiple times)
46
47
48       --tag=[]       only  consider snapshots including tag[,tag,...] (can be
49       specified multiple times)
50
51
52

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO