You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: faq/index.md
+11-11
Original file line number
Diff line number
Diff line change
@@ -131,28 +131,28 @@ So the upload speed is not always the main bottleneck. Depending on your setup,
131
131
More details on enabling BBR for network congestion for [Debian](https://wiki.crowncloud.net/?How_to_enable_BBR_on_Debian_10) or [ArchLinux](https://gist.github.com/epyonavenger/a7d0bdcdb64169c4b0031391e10ff203). Thanks to our user Frédéric for sharing this tip!
132
132
- Avoid excessive archive checking: `borg check` can read all backup segments and confirm their consistency. For large repos this can take a long time. BorgBase already uses different techniques to avoid bitrot in the storage backend, so `borg check` is not strictly necessary for this purpose. In Borgmatic set `checks` to `disabled` in the `consistency` section. If you still need consistency checks, consider using the `repository` option to limit the check to the repository. Checking all archive metadata is done on the client and very time consuming. See the official [Borg docs](https://borgbackup.readthedocs.io/en/stable/usage/check.html) for details.
133
133
134
+
134
135
### Repair Damaged Repositories
135
136
136
137
There are rare situations, where Borg repositories can be damaged by e.g. interrupted backups, incomplete migrations, hardware failures or other factors. Symptoms include:
137
138
138
139
- `Object with key XXX not found in repository`
139
140
- `Cache is newer than repository - do you have multiple, independently updated repos with same ID?`
140
141
141
-
If you don't necessarily need the data right now, but primarily want a working repository, Borg is generally good at fixing those issues and missing data will be added during the next backup run.
142
-
143
-
Some general fixes for errors on missing data:
142
+
Borg is generally good at fixing those issues and missing data will be added during the next backup run.
144
143
145
-
- First run `borg check $REPO_URL`. This will first check the repository files and then one or more archives.
146
-
- If the first step reveals errors, you should make a local repo copy, unless the data is non-critical.
147
-
- Next run `borg check --repair` to ask Borg to fix any errors.
148
-
- Finally run `borg create ...` to do a full backup run and add potentially missing data.
144
+
To fix errors related to missing data or files:
149
145
150
-
Some possible fixes for cache errors (from [here](https://github.com/borgbackup/borg/issues/3428#issuecomment-380399036)):
146
+
1. First run `borg check $REPO_URL`. This will first check the repository files and then one or more archives.
147
+
2. If the first step reveals errors, you should make a local repo copy, unless the data is non-critical.
148
+
3. Next run `borg check --repair $REPO_URL` to ask Borg to fix any errors.
149
+
4. Finally run `borg create ...` to do a full backup run and add potentially missing data.
151
150
152
-
- First try to the local cache `borg delete --cache-only $REPO_URL`
153
-
- If the first step doesn't resolve the issue, try moving or removing the security folder in `~/.config/borg/security/$REPO_ID`. Where the `REPO_ID` can be found using `borg config $REPO_URL id`
154
-
- Run a repo check with `borg check $REPO_URL`.
151
+
To fix errors related to the cache (from [here](https://github.com/borgbackup/borg/issues/3428#issuecomment-380399036)):
155
152
153
+
1. First try to the local cache `borg delete --cache-only $REPO_URL`
154
+
2. If the first step doesn't resolve the issue, try moving or removing the security folder in `~/.config/borg/security/$REPO_ID`. Where the `REPO_ID` can be found using `borg config $REPO_URL id`
0 commit comments