-
-
Notifications
You must be signed in to change notification settings - Fork 296
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[docs] Rework backups a bit #1942
Conversation
Looks great! A few comments, but otherwise good to me :). Once that other PR is in so the local media backup section can be updated (if that's good with you) we should be able to merge this. |
Cool! This looks good to me, valuable contribution. Feel free to merge once you're both happy with it, i reckon :) |
I've pushed some updates, including a little script people can use to transform the output into Borg patterns. This is all pending #1943, otherwise it doesn't make any sense. |
This changes the existing backup documentation to: * Push a bit harder on people to perform backups, it's not really just a nice to have * Removes the language about migrating to/from GoToSocial and a different ActivityPub server since that's really not supported * Adds a section about using backup software and provides an example on how to do this using Borgmatic
This adds documentation pointing people at the media list-local command in order to determine what media files they need to include as part of their backups. Provides a Python script that people can use to transform the media listing from the CLI into Borg patterns. It also includes a Borgmatic config.yaml in the repository so people can easily fetch it instead of copy-pasting from the docs.
It works either way, as a pattern like data/files/<ID> would match a file on /data/files/<ID>. But it would potentially also match any path that happens to include data/files/<ID> but not rooted at the storage-local-base-path.
Now that #1943 is squerged, should i squerge this too? 👀 |
Yup. I just rebased it and fixed a few links. |
Description
This changes the existing backup documentation to:
Checklist
Please put an x inside each checkbox to indicate that you've read and followed it:
[ ]
->[x]
If this is a documentation change, only the first checkbox must be filled (you can delete the others if you want).
go fmt ./...
andgolangci-lint run
.