forked from Deuxfleurs/garage
73 lines
2.6 KiB
Markdown
73 lines
2.6 KiB
Markdown
+++
|
|
title = "Backups (restic, duplicity...)"
|
|
weight = 25
|
|
+++
|
|
|
|
|
|
Backups are essential for disaster recovery but they are not trivial to manage.
|
|
Using Garage as your backup target will enable you to scale your storage as needed while ensuring high availability.
|
|
|
|
## Borg Backup
|
|
|
|
Borg Backup is very popular among the backup tools but it is not yet compatible with the S3 API.
|
|
We recommend using any other tool listed in this guide because they are all compatible with the S3 API.
|
|
If you still want to use Borg, you can use it with `rclone mount`.
|
|
|
|
|
|
|
|
## Restic
|
|
|
|
*External links:* [Restic Documentation > Amazon S3](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#amazon-s3)
|
|
|
|
## Duplicity
|
|
|
|
*External links:* [Duplicity > man](https://duplicity.gitlab.io/duplicity-web/vers8/duplicity.1.html) (scroll to "URL Format" and "A note on Amazon S3")
|
|
|
|
## Duplicati
|
|
|
|
*External links:* [Duplicati Documentation > Storage Providers](https://duplicati.readthedocs.io/en/latest/05-storage-providers/#s3-compatible)
|
|
|
|
The following fields need to be specified:
|
|
```
|
|
Storage Type: S3 Compatible
|
|
Use SSL: [ ] # Only if you have SSL
|
|
Server: Custom server url (s3.garage.localhost:3900)
|
|
Bucket name: bucket-name
|
|
Bucket create region: Custom region value (garage) # Or as you've specified in garage.toml
|
|
AWS Access ID: Key ID from "garage key info key-name"
|
|
AWS Access Key: Secret key from "garage key info key-name"
|
|
Client Library to use: Minio SDK
|
|
```
|
|
|
|
Click `Test connection` and then no when asked `The bucket name should start with your username, prepend automatically?`. Then it should say `Connection worked!`.
|
|
|
|
|
|
## knoxite
|
|
|
|
*External links:* [Knoxite Documentation > Storage Backends](https://knoxite.com/docs/storage-backends/#amazon-s3)
|
|
|
|
## kopia
|
|
|
|
*External links:* [Kopia Documentation > Repositories](https://kopia.io/docs/repositories/#amazon-s3)
|
|
|
|
To create the Kopia repository, you need to specify the region, the HTTP(S) endpoint, the bucket name and the access keys.
|
|
For instance, if you have an instance of garage running on `https://garage.example.com`:
|
|
|
|
```
|
|
kopia repository create s3 --region=garage --bucket=mybackups --access-key=KEY_ID --secret-access-key=SECRET_KEY --endpoint=garage.example.com
|
|
```
|
|
|
|
Or if you have an instance running on localhost, without TLS:
|
|
|
|
```
|
|
kopia repository create s3 --region=garage --bucket=mybackups --access-key=KEY_ID --secret-access-key=SECRET_KEY --endpoint=localhost:3900 --disable-tls
|
|
```
|
|
|
|
After the repository has been created, check that everything works as expected:
|
|
|
|
```
|
|
kopia repository validate-provider
|
|
```
|
|
|
|
You can then run all the standard kopia commands: `kopia snapshot create`, `kopia mount`...
|
|
Everything should work out-of-the-box.
|