Skip to content

Latest commit

 

History

History
52 lines (26 loc) · 2.39 KB

README.md

File metadata and controls

52 lines (26 loc) · 2.39 KB

Restic by Example

CI Status Go ReportCard

I'm trying to learn how restic works, and this repository relates my journey.

Tooling

This repository also provides some useful tooling for restic repositories. Please see the tooling documentation.

Target audience

This is not a user's guide, the official documentation is quite good at it.

This guide is for those of you willing to contribute to restic eventually, build tooling to augment restic’s ecosystem, or self-serve if something terrible happens with your data, empowering you to create the necessary tooling to troubleshot/fix/workaround things.

The guide

The guide only covers core restic operations. Things like the virtual filesystem, remote repository backends, the cache and some other things were intentionally left out. I may include then in a future advanced restic internal's guide.

0. Intro

1. Prerequisites

2. Restic IDs

3. File Encryption

4. Pack Files

5. Blobs

6. The Index

7. File Chunking TODO

8. Deduplication TODO

9. Recommended Reading

Note: this unofficial guide is a work in progress, from a random guy who's never contributed to restic before. You should take all this with a grain of salt until it's been reviewed by a few more eyes and this note is removed.

I may have introduced new bugs in restic's code while adapting it for this guide. Code or guide reviews and fixes for any errors found are greatly appreciated.

Credits

Most of the API code in this repository comes from restic. I've modified it so it can be used externally (moving code from internal to external packages) and added some helper functions that should make it a bit easier to use when dealing with local restic repositories.

Not all the code from restic's repository has been imported, just enough code to be able to read, write, decrypt and encrypt local repository files.