Documentation: Differential Backup Using Borgmatic#81
Open
f-seidler wants to merge 7 commits intosciapp:developfrom
Open
Documentation: Differential Backup Using Borgmatic#81f-seidler wants to merge 7 commits intosciapp:developfrom
f-seidler wants to merge 7 commits intosciapp:developfrom
Conversation
Added documentation for differential backup and restore using borgmatic.
V 0.33 added differential backup documentation
FlorianRhiem
requested changes
Feb 4, 2026
Member
FlorianRhiem
left a comment
FlorianRhiem
left a comment
There was a problem hiding this comment.
Thanks for the PR, I've added a few comments to the changes.
Adding the links is a great idea. Co-authored-by: Florian Rhiem <florian.rhiem@gmail.com>
Agreed. Co-authored-by: Florian Rhiem <florian.rhiem@gmail.com>
Sorry for the typo. Co-authored-by: Florian Rhiem <florian.rhiem@gmail.com>
Co-authored-by: Florian Rhiem <florian.rhiem@gmail.com>
Reworked initial pull request accroding to the comments.
Author
|
I think, I resolved all issues with the example code and explanations. Please, check if everything is appropriately addressed. |
ReimarBauer
reviewed
Mar 5, 2026
| .. code-block:: bash | ||
|
|
||
| docker exec -it backup borgmatic --verbosity 1 init --encryption repokey | ||
|
|
There was a problem hiding this comment.
instead of "backup" i needed the container id.
ReimarBauer
reviewed
Mar 5, 2026
| hostname: db | ||
| port: 5432 | ||
| # Remember to set username and password to the same values as in the compose file | ||
| username: postgres |
There was a problem hiding this comment.
maybe add also in the docker-compose.yml the default username. For a moment I thought about have I kept the default ;)
ReimarBauer
suggested changes
Mar 5, 2026
ReimarBauer
left a comment
ReimarBauer
left a comment
There was a problem hiding this comment.
there is a redirect in a file needed.
The storing part tested, I expect restoring does also work.
| .. code-block:: bash | ||
|
|
||
| docker exec -it backup borg key export --paper /mnt/borg-repository/repo encrypted-key-backup.txt | ||
|
|
There was a problem hiding this comment.
docker exec -it backup borg key export --paper /mnt/borg-repository/repo > encrypted-key-backup.txt
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I have added documenation for creating differential backups to the "Backup and Restore" section of the "Administrator Guide". The steps described there are derived from documentation for the borgmatic tool and adapted to the specific case of sampledb. I'm including two sample configuration files as codeblocks. They are intended for a development setup, not production.
I have tested the steps I describe locally under wsl with sampledb 0.32. I am also successfully running a similar configuration on a production system with the same sampledb version.
I successfully compiled the documentation with the proposed changes.