restic-mount(1)

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

NAME

6       restic-mount - Mount the repository
7
8
9

SYNOPSIS

11       restic mount [flags] mountpoint
12
13
14

DESCRIPTION

16       The "mount" command mounts the repository via fuse to a directory. This
17       is a read-only mount.
18
19
20

Snapshot Directories

22       If you need a different template for  directories  that  contain  snap‐
23       shots,  you  can pass a time template via --time-template and path tem‐
24       plates via --path-template.
25
26
27       Example time template without colons:
28
29
30              --time-template "2006-01-02_15-04-05"
31
32
33
34       You need to specify a sample format for  exactly  the  following  time‐
35       stamp:
36
37
38              Mon Jan 2 15:04:05 -0700 MST 2006
39
40
41
42       For details please see the documentation for time.Format() at:
43         https://godoc.org/time#Time.Format
44
45
46       For  path  templates,  you can use the following patterns which will be
47       replaced:
48           %i by short snapshot ID
49           %I by long snapshot ID
50           %u by username
51           %h by hostname
52           %t by tags
53           %T by timestamp as specified by --time-template
54
55
56       The default path templates are:
57           "ids/%i"
58           "snapshots/%T"
59           "hosts/%h/%T"
60           "tags/%t/%T"
61
62
63

EXIT STATUS

65       Exit status is 0 if the command was successful, and non-zero  if  there
66       was any error.
67
68
69

OPTIONS

71       --allow-other[=false]       allow other users to access the data in the
72       mounted directory
73
74
75       -h, --help[=false]      help for mount
76
77
78       -H, --host=[]      only consider snapshots for this host (can be speci‐
79       fied multiple times)
80
81
82       --no-default-permissions[=false]       for  'allow-other',  ignore Unix
83       permissions and allow users to read all snapshot files
84
85
86       --owner-root[=false]      use 'root' as the owner of files and dirs
87
88
89       --path=[]      only consider snapshots which  include  this  (absolute)
90       path
91
92
93       --path-template=[]       set  template for path names (can be specified
94       multiple times)
95
96
97       --tag=[]      only consider snapshots which include this taglist
98
99
100       --time-template="2006-01-02T15:04:05Z07:00"      set  template  to  use
101       for times
102
103
104

OPTIONS INHERITED FROM PARENT COMMANDS

106       --cacert=[]      file to load root certificates from (default: use sys‐
107       tem certificates)
108
109
110       --cache-dir=""      set the cache directory. (default: use  system  de‐
111       fault cache directory)
112
113
114       --cleanup-cache[=false]      auto remove old cache directories
115
116
117       --compression=auto      compression mode (only available for repository
118       format version 2), one of (auto|off|max)
119
120
121       --insecure-tls[=false]      skip TLS certificate verification when con‐
122       necting to the repository (insecure)
123
124
125       --json[=false]       set  output mode to JSON for commands that support
126       it
127
128
129       --key-hint=""      key ID of key  to  try  decrypting  first  (default:
130       $RESTIC_KEY_HINT)
131
132
133       --limit-download=0       limits  downloads  to a maximum rate in KiB/s.
134       (default: unlimited)
135
136
137       --limit-upload=0      limits uploads to a maximum rate in  KiB/s.  (de‐
138       fault: unlimited)
139
140
141       --no-cache[=false]      do not use a local cache
142
143
144       --no-lock[=false]      do not lock the repository, this allows some op‐
145       erations on read-only repositories
146
147
148       -o, --option=[]      set extended option (key=value, can  be  specified
149       multiple times)
150
151
152       --pack-size=0       set target pack size in MiB, created pack files may
153       be larger (default: $RESTIC_PACK_SIZE)
154
155
156       --password-command=""      shell command to obtain the repository pass‐
157       word from (default: $RESTIC_PASSWORD_COMMAND)
158
159
160       -p,  --password-file=""       file to read the repository password from
161       (default: $RESTIC_PASSWORD_FILE)
162
163
164       -q, --quiet[=false]      do not output comprehensive progress report
165
166
167       -r, --repo=""      repository to backup to or  restore  from  (default:
168       $RESTIC_REPOSITORY)
169
170
171       --repository-file=""       file  to  read  the repository location from
172       (default: $RESTIC_REPOSITORY_FILE)
173
174
175       --tls-client-cert=""      path to a file  containing  PEM  encoded  TLS
176       client certificate and private key
177
178
179       -v,  --verbose[=0]       be  verbose (specify multiple times or a level
180       using --verbose=n, max level/times is 3)
181
182
183