restic-prune(1)

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

NAME

6       restic-prune - Remove unneeded data from the repository
7
8
9

SYNOPSIS

11       restic prune [flags]
12
13
14

DESCRIPTION

16       The  "prune" command checks the repository and removes data that is not
17       referenced and therefore not needed any more.
18
19
20

EXIT STATUS

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

OPTIONS

28       -n,  --dry-run[=false]       do  not  modify the repository, just print
29       what would be done
30
31
32       -h, --help[=false]      help for prune
33
34
35       --max-repack-size=""      maximum size  to  repack  (allowed  suffixes:
36       k/K, m/M, g/G, t/T)
37
38
39       --max-unused="5%"       tolerate  given  limit of unused data (absolute
40       value in bytes with suffixes k/K, m/M, g/G, t/T, a value in  %  or  the
41       word 'unlimited')
42
43
44       --repack-cacheable-only[=false]      only repack packs which are cache‐
45       able
46
47
48       --repack-small[=false]      repack pack files below 80% of target  pack
49       size
50
51
52       --repack-uncompressed[=false]      repack all uncompressed data
53
54
55       --unsafe-recover-no-free-space=""       UNSAFE,  READ THE DOCUMENTATION
56       BEFORE USING! Try to recover a repository stuck with no free space.  Do
57       not use without trying out 'prune --max-repack-size 0' first.
58
59
60

OPTIONS INHERITED FROM PARENT COMMANDS

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

NAME

SYNOPSIS

DESCRIPTION

EXIT STATUS

OPTIONS

OPTIONS INHERITED FROM PARENT COMMANDS

SEE ALSO