Skip to content

Commit 5e9b492

Browse files
committed
Use numbered list for repair steps
1 parent b4eb3d3 commit 5e9b492

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

faq/index.md

+11-11
Original file line numberDiff line numberDiff line change
@@ -131,28 +131,28 @@ So the upload speed is not always the main bottleneck. Depending on your setup,
131131
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!
132132
- 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.
133133
134+
134135
### Repair Damaged Repositories
135136
136137
There are rare situations, where Borg repositories can be damaged by e.g. interrupted backups, incomplete migrations, hardware failures or other factors. Symptoms include:
137138
138139
- `Object with key XXX not found in repository`
139140
- `Cache is newer than repository - do you have multiple, independently updated repos with same ID?`
140141
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.
144143
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:
149145
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.
151150
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)):
155152
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`
155+
3. Run a repo check with `borg check $REPO_URL`.
156156
157157
158158
## Append-Only Mode

0 commit comments

Comments
 (0)