From c2f6f5178975500ad8f297aec0bc55e5ca829dd5 Mon Sep 17 00:00:00 2001 From: Nicco Date: Thu, 5 Dec 2019 00:27:01 +0100 Subject: [PATCH 1/3] Update README.md --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8a65b2e..d8599f0 100644 --- a/README.md +++ b/README.md @@ -60,13 +60,13 @@ If we would check only one location we could run the following: `autorestic chec Note that the data is automatically encrypted on the server. The key will be generated and added to your config file. Every backend will have a separate key. You should keep a copy of the keys somewhere in case your server dies. Otherwise DATA IS LOST! -### Backup +### 📦 Backup ``` autorestic backup -a ``` -### Restore +### 📼 Restore ``` autorestic restore -a --to /path/where/to/restore @@ -81,6 +81,9 @@ autorestic restore -l home --from hdd --to /path/where/to/restore This will restore the location `home` to the `/path/where/to/restore` folder and taking the data from the backend `hdd` +### 📲 Updates + +Autorestic can update itself! Super handy right? Simply run `autorestic update` and we will check for you if there are updates for restic and autorestic and install them if necessary. ## 🗂 Locations From 9c09ce1d79da0820c038ef64714ce0538f8cbf37 Mon Sep 17 00:00:00 2001 From: Nicco Date: Thu, 5 Dec 2019 00:31:05 +0100 Subject: [PATCH 2/3] Update README.md --- README.md | 90 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 50 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index d8599f0..d18bff7 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,17 @@ Autorestic is a wrapper around the amazing [restic](https://restic.net/). While - Simple interface - Fully encrypted -## Installation +###### 📒 Docs + +- [Locations](#-locations) +- [Backends](#-backends) +- [Pruning & Deleting old files](#pruning-and-snapshot-policies) +- [Excluding files](#excluding-filesfolders) +- [Hooks](#before--after-hooks) + +## 🛳 Installation + +Linux & macOS. Windows is not supported. ``` curl -s https://raw.githubusercontent.com/CupCakeArmy/autorestic/master/install.sh | bash @@ -98,43 +108,7 @@ locations: - also-backup-to-this-backend ``` -## 💽 Backends - -Backends are the place where you data will be saved. Backups are incremental and encrypted. - -### Fields - -##### `type` - -Type of the backend see a list [here](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html) - -Supported are: -- [Local](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#local) -- [Backblaze B2](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#backblaze-b2) -- [Amazon S3](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#amazon-s3) -- [Minio](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#minio-server) -- [Google Cloud Storage](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#google-cloud-storage) -- [Microsoft Azure Storage](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#microsoft-azure-blob-storage) - -For each backend you need to specify the right variables as shown in the example below. - -##### `path` - -The path on the remote server. -For object storages as - -##### Example - -```yaml -backends: - name-of-backend: - type: b2 - path: 'myAccount:myBucket/my/path' - B2_ACCOUNT_ID: backblaze_account_id - B2_ACCOUNT_KEY: backblaze_account_key -``` - -### Pruning and snapshot policies +#### Pruning and snapshot policies Autorestic supports declaring snapshot policies for location to avoid keeping old snapshot around if you don't need them. @@ -179,7 +153,7 @@ f8f8f976 2019-12-02 12:11:08 computer within 2w /etc 3 snapshots ``` -### Excluding files/folders +#### Excluding files/folders If you want to exclude certain files or folders it done easily by specifiyng the right flags in the location you desire to filter. The flags are taken straight from the [restic cli exclude rules](https://restic.readthedocs.io/en/latest/040_backup.html#excluding-files). @@ -204,7 +178,7 @@ backends: ... ``` -### Before / After hooks +#### Before / After hooks Sometimes you might want to stop an app/db before backing up data and start the service again after the backup has completed. This is what the hooks are made for. Simply add them to your location config. You can have as many commands as you wish. @@ -223,6 +197,42 @@ locations: - echo "kthxbye" ``` +## 💽 Backends + +Backends are the place where you data will be saved. Backups are incremental and encrypted. + +### Fields + +##### `type` + +Type of the backend see a list [here](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html) + +Supported are: +- [Local](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#local) +- [Backblaze B2](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#backblaze-b2) +- [Amazon S3](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#amazon-s3) +- [Minio](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#minio-server) +- [Google Cloud Storage](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#google-cloud-storage) +- [Microsoft Azure Storage](https://restic.readthedocs.io/en/stable/030_preparing_a_new_repo.html#microsoft-azure-blob-storage) + +For each backend you need to specify the right variables as shown in the example below. + +##### `path` + +The path on the remote server. +For object storages as + +##### Example + +```yaml +backends: + name-of-backend: + type: b2 + path: 'myAccount:myBucket/my/path' + B2_ACCOUNT_ID: backblaze_account_id + B2_ACCOUNT_KEY: backblaze_account_key +``` + ## Contributors This amazing people helped the project! From fd2fd9163503925a4b59e58b79c967db11914f50 Mon Sep 17 00:00:00 2001 From: Nicco Date: Thu, 5 Dec 2019 00:31:41 +0100 Subject: [PATCH 3/3] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d18bff7..536439b 100644 --- a/README.md +++ b/README.md @@ -17,10 +17,10 @@ Autorestic is a wrapper around the amazing [restic](https://restic.net/). While ###### 📒 Docs - [Locations](#-locations) + - [Pruning & Deleting old files](#pruning-and-snapshot-policies) + - [Excluding files](#excluding-filesfolders) + - [Hooks](#before--after-hooks) - [Backends](#-backends) -- [Pruning & Deleting old files](#pruning-and-snapshot-policies) -- [Excluding files](#excluding-filesfolders) -- [Hooks](#before--after-hooks) ## 🛳 Installation