From 2b5efd0499211e1e1227c4802229bc4ed1f74542 Mon Sep 17 00:00:00 2001 From: cupcakearmy Date: Sun, 28 Jun 2020 22:36:44 +0200 Subject: [PATCH] cron docs --- docs/backend/available.html | 12 +- docs/backend/overview.html | 12 +- docs/cli/backup.html | 12 +- docs/cli/check.html | 12 +- docs/cli/cron.html | 12 +- docs/cli/exec.html | 12 +- docs/cli/forget.html | 12 +- docs/cli/info.html | 14 +- docs/cli/install.html | 12 +- docs/cli/restore.html | 12 +- docs/cli/uninstall.html | 12 +- docs/cli/update.html | 12 +- docs/config.html | 12 +- docs/contrib.html | 12 +- docs/dist/codedoc-styles.css | 902 +++++++++++++++++------------------ docs/examples.html | 12 +- docs/index.html | 14 +- docs/installation.html | 12 +- docs/location/cron.html | 12 +- docs/location/docker.html | 12 +- docs/location/exclude.html | 12 +- docs/location/forget.html | 12 +- docs/location/hooks.html | 12 +- docs/location/overview.html | 14 +- docs/md/location/cron.md | 4 +- docs/qa.html | 14 +- docs/quick.html | 12 +- 27 files changed, 607 insertions(+), 607 deletions(-) diff --git a/docs/backend/available.html b/docs/backend/available.html index 9b74f30..0639621 100644 --- a/docs/backend/available.html +++ b/docs/backend/available.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkAvailable Backends

In theory all the restic backends are supported.

Those tested are the following:

linkLocal

1backends:

2  name-of-backend:

3    type: local

4    path: /data/my/backups

linkBackblaze

1backends:

2  name-of-backend:

3    type: b2

4    path: 'myAccount:myBucket/my/path'

5    B2_ACCOUNT_ID: backblaze_account_id

6    B2_ACCOUNT_KEY: backblaze_account_key

linkS3 / Minio

1backends:

2  name-of-backend:

3    type: s3

4    path: s3.amazonaws.com/bucket_name

5    # Minio

6    # path: http://localhost:9000/bucket_name

7    AWS_ACCESS_KEY_ID: my_key

8    AWS_SECRET_ACCESS_KEY: my_secret

linkSFTP

For SFTP to work you need to use configure your host inside of ~/.ssh/config as password prompt is not supported. For more information on this topic please see the official docs on the matter.

1backends:

2  name-of-backend:

3    type: sftp

4    path: my-host:/remote/path/on/the/server

Available BackendsLocalBackblazeS3 / MinioSFTP
Star

Created With

linkAvailable Backends

In theory all the restic backends are supported.

Those tested are the following:

linkLocal

1backends:

2  name-of-backend:

3    type: local

4    path: /data/my/backups

linkBackblaze

1backends:

2  name-of-backend:

3    type: b2

4    path: 'myAccount:myBucket/my/path'

5    B2_ACCOUNT_ID: backblaze_account_id

6    B2_ACCOUNT_KEY: backblaze_account_key

linkS3 / Minio

1backends:

2  name-of-backend:

3    type: s3

4    path: s3.amazonaws.com/bucket_name

5    # Minio

6    # path: http://localhost:9000/bucket_name

7    AWS_ACCESS_KEY_ID: my_key

8    AWS_SECRET_ACCESS_KEY: my_secret

linkSFTP

For SFTP to work you need to use configure your host inside of ~/.ssh/config as password prompt is not supported. For more information on this topic please see the official docs on the matter.

1backends:

2  name-of-backend:

3    type: sftp

4    path: my-host:/remote/path/on/the/server

Available BackendsLocalBackblazeS3 / MinioSFTP

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/backend/overview.html b/docs/backend/overview.html index 09a3669..85eddc2 100644 --- a/docs/backend/overview.html +++ b/docs/backend/overview.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link💽 Backends

Backends are the ouputs of the backup process. Each location needs at least one.

.autorestic.yml
1backends:

2  name-of-backend:

3    type: local

4    path: /data/my/backups

linkTypes

We restic supports multiple types of backends. See the full list for details.

💽 BackendsTypes
Star

Created With

link💽 Backends

Backends are the ouputs of the backup process. Each location needs at least one.

.autorestic.yml
1backends:

2  name-of-backend:

3    type: local

4    path: /data/my/backups

linkTypes

We restic supports multiple types of backends. See the full list for details.

💽 BackendsTypes

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/backup.html b/docs/cli/backup.html index 10ba14c..e38536f 100644 --- a/docs/cli/backup.html +++ b/docs/cli/backup.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkBackup

1autorestic backup [-l, --location] [-a, --all]

Performes a backup of all locations if the -a flag is passed. To only backup some locations pass one or more -l or --location flags.

1autorestic backup -l my-location

Backup
Star

Created With

linkBackup

1autorestic backup [-l, --location] [-a, --all]

Performes a backup of all locations if the -a flag is passed. To only backup some locations pass one or more -l or --location flags.

1autorestic backup -l my-location

Backup

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/check.html b/docs/cli/check.html index 12ee24c..ecbd9d9 100644 --- a/docs/cli/check.html +++ b/docs/cli/check.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkcheck

1autorestic check [-b, --backend]  [-a, --all]

Cheks if one or more backend are configured properly and initializes them if they are not already.

This is mostly an internal command, but useful to verify if a backend is configured correctly.

1autorestic check -b my-backend

check
Star

Created With

linkcheck

1autorestic check [-b, --backend]  [-a, --all]

Cheks if one or more backend are configured properly and initializes them if they are not already.

This is mostly an internal command, but useful to verify if a backend is configured correctly.

1autorestic check -b my-backend

check

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/cron.html b/docs/cli/cron.html index 6526509..abfe263 100644 --- a/docs/cli/cron.html +++ b/docs/cli/cron.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkCron

1autorestic cron

This command is modtly intended to be triggered by an automated system like systemd or crontab.

It will run cron jobs es specified in the cron section of a specific location.

Cron
Star

Created With

linkCron

1autorestic cron

This command is modtly intended to be triggered by an automated system like systemd or crontab.

It will run cron jobs es specified in the cron section of a specific location.

Cron

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/exec.html b/docs/cli/exec.html index 3e69db0..d15b4b8 100644 --- a/docs/cli/exec.html +++ b/docs/cli/exec.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkExec

1autorestic exec [-b, --backend]  [-a, --all] <command> -- [native options]

This is avery handy command which enables you to run any native restic command on desired backends. An example would be listing all the snapshots of all your backends:

1autorestic exec -a -- snapshots

With exec you can basically run every cli command that you would be able to run with the restic cli. It only prefillst path, key, etc.

Exec
Star

Created With

linkExec

1autorestic exec [-b, --backend]  [-a, --all] <command> -- [native options]

This is avery handy command which enables you to run any native restic command on desired backends. An example would be listing all the snapshots of all your backends:

1autorestic exec -a -- snapshots

With exec you can basically run every cli command that you would be able to run with the restic cli. It only prefillst path, key, etc.

Exec

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/forget.html b/docs/cli/forget.html index 81148f1..4d95f62 100644 --- a/docs/cli/forget.html +++ b/docs/cli/forget.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkForget

1autorestic forget [-l, --location] [-a, --all] [--dry-run]

This will prune and remove old data form the backends according to the keep policy you have specified for the location

The --dry-run flag will do a dry run showing what would have been deleted, but won't touch the actual data.

Forget
Star

Created With

linkForget

1autorestic forget [-l, --location] [-a, --all] [--dry-run]

This will prune and remove old data form the backends according to the keep policy you have specified for the location

The --dry-run flag will do a dry run showing what would have been deleted, but won't touch the actual data.

Forget

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/info.html b/docs/cli/info.html index 33b6987..03d57e1 100644 --- a/docs/cli/info.html +++ b/docs/cli/info.html @@ -35,23 +35,23 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkinfo

Displays the config file that autorestic is refering to. -Usefull when you want to quickly see what locations are being backuped where.

Pro tip: if it gets a bit long you can read it more easily with autorestic info | less 😉

1autorestic info

linkWith a custom file

1autorestic -c path/to/some/config.yml info

infoWith a custom file
Star

Created With

linkinfo

Displays the config file that autorestic is refering to. +Usefull when you want to quickly see what locations are being backuped where.

Pro tip: if it gets a bit long you can read it more easily with autorestic info | less 😉

1autorestic info

linkWith a custom file

1autorestic -c path/to/some/config.yml info

infoWith a custom file

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -60,4 +60,4 @@ Usefull when you want to quickly see what locations are being backuped where.

Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/install.html b/docs/cli/install.html index 9a2eb74..8cd0cd3 100644 --- a/docs/cli/install.html +++ b/docs/cli/install.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkInstall

Installs both restic and autorestic to /usr/local/bin.

1autorestic install

Install
Star

Created With

linkInstall

Installs both restic and autorestic to /usr/local/bin.

1autorestic install

Install

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/restore.html b/docs/cli/restore.html index d080620..f320ab3 100644 --- a/docs/cli/restore.html +++ b/docs/cli/restore.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkRestore

1autorestic restore [-l, --location] [--from backend] [--to <out dir>]

This will restore all the locations to the selected target. If for one location there are more than one backends specified autorestic will take the first one.

linkExample

1autorestic 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

RestoreExample
Star

Created With

linkRestore

1autorestic restore [-l, --location] [--from backend] [--to <out dir>]

This will restore all the locations to the selected target. If for one location there are more than one backends specified autorestic will take the first one.

linkExample

1autorestic 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

RestoreExample

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/uninstall.html b/docs/cli/uninstall.html index ace7aab..229acbf 100644 --- a/docs/cli/uninstall.html +++ b/docs/cli/uninstall.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkUninstall

Installs both restic and autorestic from /usr/local/bin.

1autorestic uninstall

Uninstall
Star

Created With

linkUninstall

Installs both restic and autorestic from /usr/local/bin.

1autorestic uninstall

Uninstall

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/cli/update.html b/docs/cli/update.html index 19e9e68..3f67e57 100644 --- a/docs/cli/update.html +++ b/docs/cli/update.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkUpdate

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.

1autorestic update

Updates both restic and autorestic automagically.

Update
Star

Created With

linkUpdate

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.

1autorestic update

Updates both restic and autorestic automagically.

Update

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/config.html b/docs/config.html index e6d543a..cf7e66a 100644 --- a/docs/config.html +++ b/docs/config.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link🎛 Config File

linkPath

By default autorestic searches for a .autorestic.yml file in the current directory and your home folder.

You can also specify a custom file with the -c path/to/some/config.yml

⚠️ WARNING ⚠️

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 or config file somewhere in case your server dies. Otherwise DATA IS LOST!

linkExample configuration

.autorestic.yml
1locations:

2  home:

3    from: /home/me

4    to: remote

5

6  important:

7    from: /path/to/important/stuff

8    to:

9      - remote

10      - hdd

11

12backends:

13  remote:

14    type: b2

15    path: 'myBucket:backup/home'

16    B2_ACCOUNT_ID: account_id

17    B2_ACCOUNT_KEY: account_key

18

19  hdd:

20    type: local

21    path: /mnt/my_external_storage

🎛 Config FilePathExample configuration
Star

Created With

link🎛 Config File

linkPath

By default autorestic searches for a .autorestic.yml file in the current directory and your home folder.

  • ./.autorestic.yml
  • ~/.autorestic.yml

You can also specify a custom file with the -c path/to/some/config.yml

⚠️ WARNING ⚠️

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 or config file somewhere in case your server dies. Otherwise DATA IS LOST!

linkExample configuration

.autorestic.yml
1locations:

2  home:

3    from: /home/me

4    to: remote

5

6  important:

7    from: /path/to/important/stuff

8    to:

9      - remote

10      - hdd

11

12backends:

13  remote:

14    type: b2

15    path: 'myBucket:backup/home'

16    B2_ACCOUNT_ID: account_id

17    B2_ACCOUNT_KEY: account_key

18

19  hdd:

20    type: local

21    path: /mnt/my_external_storage

🎛 Config FilePathExample configuration

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/contrib.html b/docs/contrib.html index 1d652f1..e9b3698 100644 --- a/docs/contrib.html +++ b/docs/contrib.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link🙋‍♀️🙋‍♂️ Contributors

This amazing people helped the project!

🙋‍♀️🙋‍♂️ Contributors
Star

Created With

link🙋‍♀️🙋‍♂️ Contributors

This amazing people helped the project!

  • @ChanceM [Docs]
  • @EliotBerriot [Docs, Pruning, S3]
🙋‍♀️🙋‍♂️ Contributors

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/dist/codedoc-styles.css b/docs/dist/codedoc-styles.css index 16431b6..3b4ff83 100644 --- a/docs/dist/codedoc-styles.css +++ b/docs/dist/codedoc-styles.css @@ -21,62 +21,420 @@ .heading-0-0-1:hover .anchor-0-0-2:hover { opacity: 1; } -.collapse-0-0-3>.label { - cursor: pointer; - margin: 8px 0; - display: flex; - align-items: center; +.code-0-0-3 { + color: #e0e0e0; + display: block; + outline: none; + padding: 24px 0; + position: relative; + font-size: 13px; + background: #212121; + box-shadow: 0 6px 12px rgba(0, 0, 0, .25); + overflow-x: auto; user-select: none; + border-radius: 3px; + -webkit-user-select: none; } -.collapse-0-0-3>.content { - opacity: 0; - max-height: 0; - transition: opacity .3s; - visibility: hidden; - border-left: 2px solid rgba(224, 224, 224, 0.5); - padding-left: 16px; +pre.with-bar .code-0-0-3 { + padding-top: 0; } -.collapse-0-0-3.open>.content { - opacity: 1; - max-height: none; - visibility: visible; +.code-0-0-3 .token.keyword { + color: #7187ff; } -.collapse-0-0-3.open>.label .icon-font { - transform: rotate(90deg); +.code-0-0-3 .token.string { + color: #69f0ae; } -body.dark-mode-animate .collapse-0-0-3>.content { - transition: transform .15s, opacity .15s, border-color .3s; +.code-0-0-3 .token.number { + color: #ffc400; } -body.dark .collapse-0-0-3>.content { - border-color: rgba(49, 49, 49, 0.5); +.code-0-0-3 .token.boolean { + color: #ffc400; +} +.code-0-0-3 .token.operator { + color: #18ffff; +} +.code-0-0-3 .token.function { + color: #e0e0e0; +} +.code-0-0-3 .token.parameter { + color: #e0e0e0; +} +.code-0-0-3 .token.comment { + color: #757575; +} +.code-0-0-3 .token.tag { + color: #ffa372; +} +.code-0-0-3 .token.builtin { + color: #e0e0e0; +} +.code-0-0-3 .token.punctuation { + color: #fcf7bb; +} +.code-0-0-3 .token.class-name { + color: #e0e0e0; +} +.code-0-0-3 .token.attr-name { + color: #f6d186; +} +.code-0-0-3 .token.attr-value { + color: #69f0ae; +} +.code-0-0-3 .token.plain-text { + color: #bdbdbd; +} +.code-0-0-3 .token.script { + color: #e0e0e0; +} +.code-0-0-3 .token.placeholder { + color: #18ffff; +} +.code-0-0-3 .token.selector { + color: #ffa372; +} +.code-0-0-3 .token.property { + color: #f6d186; +} +.code-0-0-3 .token.important { + color: #be79df; +} +.code-0-0-3.scss .token.function, .code-0-0-3.css .token.function, .code-0-0-3.sass .token.function { + color: #9aceff; +} +.code-0-0-3 .token.key { + color: #f6d186; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .collapse-0-0-3>.content { + body:not(.dark-mode-animate) .code-0-0-3 { + color: #e0e0e0; + background: #000000; + box-shadow: 0 6px 12px #121212; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.keyword { + color: #7187ff; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.string { + color: #69f0ae; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.number { + color: #ffc400; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.boolean { + color: #ffc400; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.operator { + color: #18ffff; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.function { + color: #e0e0e0; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.parameter { + color: #e0e0e0; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.comment { + color: #757575; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.tag { + color: #ffa372; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.builtin { + color: #e0e0e0; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.punctuation { + color: #fcf7bb; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.class-name { + color: #e0e0e0; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.attr-name { + color: #f6d186; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.attr-value { + color: #69f0ae; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.plain-text { + color: #bdbdbd; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.script { + color: #e0e0e0; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.placeholder { + color: #18ffff; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.selector { + color: #ffa372; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.property { + color: #f6d186; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.important { + color: #be79df; + } + body:not(.dark-mode-animate) .code-0-0-3.scss .token.function, body:not(.dark-mode-animate) .code-0-0-3.css .token.function, body:not(.dark-mode-animate) .code-0-0-3.sass .token.function { + color: #9aceff; + } + body:not(.dark-mode-animate) .code-0-0-3 .token.key { + color: #f6d186; + } +} + body.dark .code-0-0-3 { + color: #e0e0e0; + background: #000000; + box-shadow: 0 6px 12px #121212; + } + body.dark .code-0-0-3 .token.keyword { + color: #7187ff; + } + body.dark .code-0-0-3 .token.string { + color: #69f0ae; + } + body.dark .code-0-0-3 .token.number { + color: #ffc400; + } + body.dark .code-0-0-3 .token.boolean { + color: #ffc400; + } + body.dark .code-0-0-3 .token.operator { + color: #18ffff; + } + body.dark .code-0-0-3 .token.function { + color: #e0e0e0; + } + body.dark .code-0-0-3 .token.parameter { + color: #e0e0e0; + } + body.dark .code-0-0-3 .token.comment { + color: #757575; + } + body.dark .code-0-0-3 .token.tag { + color: #ffa372; + } + body.dark .code-0-0-3 .token.builtin { + color: #e0e0e0; + } + body.dark .code-0-0-3 .token.punctuation { + color: #fcf7bb; + } + body.dark .code-0-0-3 .token.class-name { + color: #e0e0e0; + } + body.dark .code-0-0-3 .token.attr-name { + color: #f6d186; + } + body.dark .code-0-0-3 .token.attr-value { + color: #69f0ae; + } + body.dark .code-0-0-3 .token.plain-text { + color: #bdbdbd; + } + body.dark .code-0-0-3 .token.script { + color: #e0e0e0; + } + body.dark .code-0-0-3 .token.placeholder { + color: #18ffff; + } + body.dark .code-0-0-3 .token.selector { + color: #ffa372; + } + body.dark .code-0-0-3 .token.property { + color: #f6d186; + } + body.dark .code-0-0-3 .token.important { + color: #be79df; + } + body.dark .code-0-0-3.scss .token.function, body.dark .code-0-0-3.css .token.function, body.dark .code-0-0-3.sass .token.function { + color: #9aceff; + } + body.dark .code-0-0-3 .token.key { + color: #f6d186; + } + .lineCounter-0-0-4 { + left: 0; + color: transparent; + width: 24px; + height: 1.25rem; + display: inline-flex; + position: sticky; + font-size: 10px; + background: #212121; + align-items: center; + border-right: 2px solid rgba(255, 255, 255, .015); + margin-right: 12px; + padding-right: 12px; + flex-direction: row-reverse; + vertical-align: top; + } + .lineCounter-0-0-4.prim { + color: #616161; + } +@media (prefers-color-scheme: dark) { + body:not(.dark-mode-animate) .lineCounter-0-0-4 { + background: #000000; + border-color: rgba(255, 255, 255, .015); + } + body:not(.dark-mode-animate) .lineCounter-0-0-4.prim { + color: #616161; + } +} + body.dark .lineCounter-0-0-4 { + background: #000000; + border-color: rgba(255, 255, 255, .015); + } + body.dark .lineCounter-0-0-4.prim { + color: #616161; + } + .line-0-0-5 { + cursor: pointer; + height: 1.25rem; + display: inline-block; + min-width: 100%; + background: transparent; + transition: opacity .15s; + } + .has-selection .line-0-0-5:not(.selected) { + opacity: 0.35; + transition: opacity 3s; + } + .line-0-0-5.highlight { + color: #ffffff; + background: rgb(40, 46, 73); + } + .line-0-0-5.selected .lineCounter-0-0-4 { + border-color: #7187ff !important; + } + .line-0-0-5:hover, .line-0-0-5.selected { + background: #3b3b3b; + } + .line-0-0-5:hover .lineCounter-0-0-4 { + border-color: rgba(255, 255, 255, .1); + } + body.dark .line-0-0-5:hover .lineCounter-0-0-4 { + border-color: rgba(255, 255, 255, .1); + } + .line-0-0-5:hover .lineCounter-0-0-4, .line-0-0-5.selected .lineCounter-0-0-4 { + color: #7187ff; + background: #3b3b3b !important; + } + body.dark .line-0-0-5:hover, body.dark .line-0-0-5.selected { + background: #1a1a1a !important; + } + body.dark .line-0-0-5:hover .lineCounter-0-0-4, body.dark .line-0-0-5.selected .lineCounter-0-0-4 { + color: #7187ff; + background: #1a1a1a !important; + } + body.dark .line-0-0-5.selected .lineCounter-0-0-4 { + border-color: #7187ff !important; + } + .line-0-0-5.highlight .lineCounter-0-0-4 { + background: rgb(40, 46, 73); + } +@media (prefers-color-scheme: dark) { + body:not(.dark-mode-animate) .line-0-0-5.highlight { + color: #ffffff; + background: rgb(28, 29, 48); + } + body:not(.dark-mode-animate) .line-0-0-5.highlight .lineCounter-0-0-4 { + background: rgb(28, 29, 48); + } +} + body.dark .line-0-0-5.highlight { + color: #ffffff; + background: rgb(28, 29, 48); + } + body.dark .line-0-0-5.highlight .lineCounter-0-0-4 { + background: rgb(28, 29, 48); + } + .wmbar-0-0-6 { + left: 0; + display: none; + padding: 16px; + position: sticky; + } + .wmbar-0-0-6>span { + display: block; + opacity: 0.5; + flex-grow: 1; + font-size: 12px; + text-align: center; + font-family: sans-serif; + margin-right: 64px; + } + .wmbar-0-0-6>span:first-child, .wmbar-0-0-6>span:nth-child(2), .wmbar-0-0-6>span:nth-child(3) { + width: 8px; + height: 8px; + opacity: 1; + flex-grow: 0; + margin-right: 8px; + border-radius: 8px; + } + pre.with-bar .wmbar-0-0-6 { + display: flex; + } + .wmbar-0-0-6>span:first-child:first-child, .wmbar-0-0-6>span:nth-child(2):first-child, .wmbar-0-0-6>span:nth-child(3):first-child { + background: rgb(255, 95, 86); + } + .wmbar-0-0-6>span:first-child:nth-child(2), .wmbar-0-0-6>span:nth-child(2):nth-child(2), .wmbar-0-0-6>span:nth-child(3):nth-child(2) { + background: rgb(255, 189, 46); + } + .wmbar-0-0-6>span:first-child:nth-child(3), .wmbar-0-0-6>span:nth-child(2):nth-child(3), .wmbar-0-0-6>span:nth-child(3):nth-child(3) { + background: rgb(39, 201, 63); + } + .collapse-0-0-7>.label { + cursor: pointer; + margin: 8px 0; + display: flex; + align-items: center; + user-select: none; + } + .collapse-0-0-7>.content { + opacity: 0; + max-height: 0; + transition: opacity .3s; + visibility: hidden; + border-left: 2px solid rgba(224, 224, 224, 0.5); + padding-left: 16px; + } + .collapse-0-0-7.open>.content { + opacity: 1; + max-height: none; + visibility: visible; + } + .collapse-0-0-7.open>.label .icon-font { + transform: rotate(90deg); + } + body.dark-mode-animate .collapse-0-0-7>.content { + transition: transform .15s, opacity .15s, border-color .3s; + } + body.dark .collapse-0-0-7>.content { + border-color: rgba(49, 49, 49, 0.5); + } +@media (prefers-color-scheme: dark) { + body:not(.dark-mode-animate) .collapse-0-0-7>.content { border-color: rgba(49, 49, 49, 0.5); } } - .collapse-0-0-3>.label .text { + .collapse-0-0-7>.label .text { flex-grow: 1; } - .collapse-0-0-3>.label .icon-font { + .collapse-0-0-7>.label .icon-font { margin-right: 32px; } - .collapse-0-0-3>.label:hover { + .collapse-0-0-7>.label:hover { color: #1eb2a6; transition: color .15s; } - body.dark .collapse-0-0-3>.label:hover { + body.dark .collapse-0-0-7>.label:hover { color: #1eb2a6; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .collapse-0-0-3>.label:hover { + body:not(.dark-mode-animate) .collapse-0-0-7>.label:hover { color: #1eb2a6; } } - body.dark-mode-animate .collapse-0-0-3>.label .icon-font { + body.dark-mode-animate .collapse-0-0-7>.label .icon-font { transition: transform .15s; } - .watermark-0-0-4 { + .watermark-0-0-8 { color: #424242; cursor: pointer; display: inline-block; @@ -85,41 +443,41 @@ body.dark .collapse-0-0-3>.content { transition: opacity .15s; text-decoration: none !important; } - body.dark-mode-animate .watermark-0-0-4 { + body.dark-mode-animate .watermark-0-0-8 { transition: opacity .15s, color .3s; } - .watermark-0-0-4:hover { + .watermark-0-0-8:hover { opacity: 1; text-decoration: none; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .watermark-0-0-4 { + body:not(.dark-mode-animate) .watermark-0-0-8 { color: #eeeeee; } } - body.dark .watermark-0-0-4 { + body.dark .watermark-0-0-8 { color: #eeeeee; } - .watermark-0-0-4 svg { + .watermark-0-0-8 svg { width: 2.8rem; display: block; margin-top: .25rem; } - .watermark-0-0-4 svg g { + .watermark-0-0-8 svg g { fill: #424242; } - body.dark-mode-animate .watermark-0-0-4 svg g { + body.dark-mode-animate .watermark-0-0-8 svg g { transition: fill .3s; } - body.dark .watermark-0-0-4 svg g { + body.dark .watermark-0-0-8 svg g { fill: #eeeeee; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .watermark-0-0-4 svg g { + body:not(.dark-mode-animate) .watermark-0-0-8 svg g { fill: #eeeeee; } } - .header-0-0-5 { + .header-0-0-9 { top: 0; right: 0; padding: 32px; @@ -127,7 +485,7 @@ body.dark .collapse-0-0-3>.content { position: fixed; text-align: right; } - .footer-0-0-6 { + .footer-0-0-10 { left: 0; right: 0; bottom: 0; @@ -142,67 +500,67 @@ body.dark .collapse-0-0-3>.content { justify-content: center; -webkit-backdrop-filter: blur(12px); } - body.dark-mode-animate .footer-0-0-6 { + body.dark-mode-animate .footer-0-0-10 { transition: background .3s; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .footer-0-0-6 { + body:not(.dark-mode-animate) .footer-0-0-10 { background: rgba(33, 33, 33, 0.85); } } - body.dark .footer-0-0-6 { + body.dark .footer-0-0-10 { background: rgba(33, 33, 33, 0.85); } - .footer-0-0-6 .main { + .footer-0-0-10 .main { overflow: hidden; flex-grow: 1; text-align: center; } - .footer-0-0-6 .left { + .footer-0-0-10 .left { padding-left: 32px; } - .footer-0-0-6 .right { + .footer-0-0-10 .right { padding-right: 32px; } @media screen and (max-width: 800px) { - .footer-0-0-6 .left { + .footer-0-0-10 .left { padding-left: 16px; } - .footer-0-0-6 .right { + .footer-0-0-10 .right { padding-right: 16px; } } - .footer-0-0-6 .main>.inside { + .footer-0-0-10 .main>.inside { display: inline-flex; overflow: auto; max-width: 100%; align-items: center; } - .footer-0-0-6 .main>.inside hr { + .footer-0-0-10 .main>.inside hr { width: 2px; border: none; height: 16px; margin: 16px; background: #e0e0e0; } - .footer-0-0-6 .main>.inside a { + .footer-0-0-10 .main>.inside a { text-decoration: none; } - .footer-0-0-6 .main>.inside a:hover { + .footer-0-0-10 .main>.inside a:hover { text-decoration: underline ; } - body.dark-mode-animate .footer-0-0-6 .main>.inside hr { + body.dark-mode-animate .footer-0-0-10 .main>.inside hr { transition: background .3s; } - body.dark .footer-0-0-6 .main>.inside hr { + body.dark .footer-0-0-10 .main>.inside hr { background: #313131; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .footer-0-0-6 .main>.inside hr { + body:not(.dark-mode-animate) .footer-0-0-10 .main>.inside hr { background: #313131; } } - .toc-0-0-7 { + .toc-0-0-11 { top: 0; left: 0; width: calc(50vw - 464px); @@ -216,35 +574,35 @@ body.dark .collapse-0-0-3>.content { flex-direction: column; padding-bottom: 64px; } - body.dark-mode-animate .toc-0-0-7 { + body.dark-mode-animate .toc-0-0-11 { transition: background .3s, border-color .3s; } - body.dark .toc-0-0-7 { + body.dark .toc-0-0-11 { background: #1f1f1f; border-color: #282828; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .toc-0-0-7 { + body:not(.dark-mode-animate) .toc-0-0-11 { background: #1f1f1f; border-color: #282828; } } @media screen and (max-width: 1200px) { - .toc-0-0-7 { + .toc-0-0-11 { width: 100vw; transform: translateX(-110vw); } } - .toc-0-0-7.animated { + .toc-0-0-11.animated { transition: transform .3s; } - .toc-0-0-7.active { + .toc-0-0-11.active { transform: translateX(0); } - .toc-0-0-7 p { + .toc-0-0-11 p { margin: 0; } - .toc-0-0-7 a { + .toc-0-0-11 a { border: 1px solid transparent; display: block; padding: 8px; @@ -254,49 +612,49 @@ body.dark .collapse-0-0-3>.content { border-radius: 3px; text-decoration: none; } - body.dark-mode-animate .toc-0-0-7 a { + body.dark-mode-animate .toc-0-0-11 a { transition: border-color .3s, background .3s; } - .toc-0-0-7 a:hover { + .toc-0-0-11 a:hover { background: #f5f5f5; text-decoration: none; } - .toc-0-0-7 a.current { + .toc-0-0-11 a.current { background: #f5f5f5; border-color: #e7e7e7; margin-right: 0; border-top-right-radius: 0; border-bottom-right-radius: 0; } - body.dark .toc-0-0-7 a.current { + body.dark .toc-0-0-11 a.current { background: hsl(0, 0%, 13.2%); border-color: #282828; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .toc-0-0-7 a.current { + body:not(.dark-mode-animate) .toc-0-0-11 a.current { background: #212121; border-color: #282828; } } @media screen and (max-width: 1200px) { - .toc-0-0-7 a.current { + .toc-0-0-11 a.current { border-right: 1px solid; margin-right: -8px; border-radius: 3px; } } - body.dark .toc-0-0-7 a:hover { + body.dark .toc-0-0-11 a:hover { background: hsl(0, 0%, 13.2%); } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .toc-0-0-7 a:hover { + body:not(.dark-mode-animate) .toc-0-0-11 a:hover { background: hsl(0, 0%, 13.2%); } } - body.dark-mode-animate .toc-0-0-7.animated { + body.dark-mode-animate .toc-0-0-11.animated { transition: transform .3s, background .3s, border-color .3s; } - .content-0-0-8 { + .content-0-0-12 { padding: 32px; overflow: auto; flex-grow: 1; @@ -304,12 +662,12 @@ body.dark .collapse-0-0-3>.content { padding-right: 0; } @media screen and (max-width: 1200px) { - .content-0-0-8 { + .content-0-0-12 { margin-right: 0; padding-right: 32px; } } - .contentnav-0-0-10 { + .contentnav-0-0-14 { right: 0; width: calc(50vw - 496px); bottom: 96px; @@ -320,56 +678,56 @@ body.dark .collapse-0-0-3>.content { padding-left: 48px; } @media screen and (max-width: 1200px) { - .contentnav-0-0-10 { + .contentnav-0-0-14 { display: none; } } - .contentnav-0-0-10 a { + .contentnav-0-0-14 a { color: #424242; display: block; opacity: 0.2; text-decoration: none; } @media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .contentnav-0-0-10 { + body:not(.dark-mode-animate) .contentnav-0-0-14 { border-color: #313131; } - body:not(.dark-mode-animate) .contentnav-0-0-10 a { + body:not(.dark-mode-animate) .contentnav-0-0-14 a { color: #eeeeee; } - body:not(.dark-mode-animate) .contentnav-0-0-10 a:hover, body:not(.dark-mode-animate) .contentnav-0-0-10 a.active { + body:not(.dark-mode-animate) .contentnav-0-0-14 a:hover, body:not(.dark-mode-animate) .contentnav-0-0-14 a.active { color: #1eb2a6; } } - body.dark .contentnav-0-0-10 { + body.dark .contentnav-0-0-14 { border-color: #313131; } - body.dark .contentnav-0-0-10 a { + body.dark .contentnav-0-0-14 a { color: #eeeeee; } - body.dark .contentnav-0-0-10 a:hover, body.dark .contentnav-0-0-10 a.active { + body.dark .contentnav-0-0-14 a:hover, body.dark .contentnav-0-0-14 a.active { color: #1eb2a6; } - body.dark-mode-animate .contentnav-0-0-10 a { + body.dark-mode-animate .contentnav-0-0-14 a { transition: color .3s, opacity .3s; } - .contentnav-0-0-10 a:hover, .contentnav-0-0-10 a.active { + .contentnav-0-0-14 a:hover, .contentnav-0-0-14 a.active { color: #1eb2a6; opacity: 1; } - .contentnav-0-0-10 a.h2 { + .contentnav-0-0-14 a.h2 { margin-left: 12px; } - .contentnav-0-0-10 a.h3 { + .contentnav-0-0-14 a.h3 { margin-left: 24px; } - .contentnav-0-0-10 a.h4 { + .contentnav-0-0-14 a.h4 { margin-left: 36px; } - .contentnav-0-0-10 a.h5 { + .contentnav-0-0-14 a.h5 { margin-left: 48px; } - .contentnav-0-0-10 a.h6 { + .contentnav-0-0-14 a.h6 { margin-left: 60px; } * { @@ -510,362 +868,4 @@ body.dark code { color: #e0e0e0; background: #282828; } -} - .code-0-0-11 { - color: #e0e0e0; - display: block; - outline: none; - padding: 24px 0; - position: relative; - font-size: 13px; - background: #212121; - box-shadow: 0 6px 12px rgba(0, 0, 0, .25); - overflow-x: auto; - user-select: none; - border-radius: 3px; - -webkit-user-select: none; - } - pre.with-bar .code-0-0-11 { - padding-top: 0; - } - .code-0-0-11 .token.keyword { - color: #7187ff; - } - .code-0-0-11 .token.string { - color: #69f0ae; - } - .code-0-0-11 .token.number { - color: #ffc400; - } - .code-0-0-11 .token.boolean { - color: #ffc400; - } - .code-0-0-11 .token.operator { - color: #18ffff; - } - .code-0-0-11 .token.function { - color: #e0e0e0; - } - .code-0-0-11 .token.parameter { - color: #e0e0e0; - } - .code-0-0-11 .token.comment { - color: #757575; - } - .code-0-0-11 .token.tag { - color: #ffa372; - } - .code-0-0-11 .token.builtin { - color: #e0e0e0; - } - .code-0-0-11 .token.punctuation { - color: #fcf7bb; - } - .code-0-0-11 .token.class-name { - color: #e0e0e0; - } - .code-0-0-11 .token.attr-name { - color: #f6d186; - } - .code-0-0-11 .token.attr-value { - color: #69f0ae; - } - .code-0-0-11 .token.plain-text { - color: #bdbdbd; - } - .code-0-0-11 .token.script { - color: #e0e0e0; - } - .code-0-0-11 .token.placeholder { - color: #18ffff; - } - .code-0-0-11 .token.selector { - color: #ffa372; - } - .code-0-0-11 .token.property { - color: #f6d186; - } - .code-0-0-11 .token.important { - color: #be79df; - } - .code-0-0-11.scss .token.function, .code-0-0-11.css .token.function, .code-0-0-11.sass .token.function { - color: #9aceff; - } - .code-0-0-11 .token.key { - color: #f6d186; - } -@media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .code-0-0-11 { - color: #e0e0e0; - background: #000000; - box-shadow: 0 6px 12px #121212; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.keyword { - color: #7187ff; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.string { - color: #69f0ae; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.number { - color: #ffc400; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.boolean { - color: #ffc400; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.operator { - color: #18ffff; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.function { - color: #e0e0e0; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.parameter { - color: #e0e0e0; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.comment { - color: #757575; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.tag { - color: #ffa372; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.builtin { - color: #e0e0e0; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.punctuation { - color: #fcf7bb; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.class-name { - color: #e0e0e0; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.attr-name { - color: #f6d186; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.attr-value { - color: #69f0ae; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.plain-text { - color: #bdbdbd; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.script { - color: #e0e0e0; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.placeholder { - color: #18ffff; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.selector { - color: #ffa372; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.property { - color: #f6d186; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.important { - color: #be79df; - } - body:not(.dark-mode-animate) .code-0-0-11.scss .token.function, body:not(.dark-mode-animate) .code-0-0-11.css .token.function, body:not(.dark-mode-animate) .code-0-0-11.sass .token.function { - color: #9aceff; - } - body:not(.dark-mode-animate) .code-0-0-11 .token.key { - color: #f6d186; - } -} - body.dark .code-0-0-11 { - color: #e0e0e0; - background: #000000; - box-shadow: 0 6px 12px #121212; - } - body.dark .code-0-0-11 .token.keyword { - color: #7187ff; - } - body.dark .code-0-0-11 .token.string { - color: #69f0ae; - } - body.dark .code-0-0-11 .token.number { - color: #ffc400; - } - body.dark .code-0-0-11 .token.boolean { - color: #ffc400; - } - body.dark .code-0-0-11 .token.operator { - color: #18ffff; - } - body.dark .code-0-0-11 .token.function { - color: #e0e0e0; - } - body.dark .code-0-0-11 .token.parameter { - color: #e0e0e0; - } - body.dark .code-0-0-11 .token.comment { - color: #757575; - } - body.dark .code-0-0-11 .token.tag { - color: #ffa372; - } - body.dark .code-0-0-11 .token.builtin { - color: #e0e0e0; - } - body.dark .code-0-0-11 .token.punctuation { - color: #fcf7bb; - } - body.dark .code-0-0-11 .token.class-name { - color: #e0e0e0; - } - body.dark .code-0-0-11 .token.attr-name { - color: #f6d186; - } - body.dark .code-0-0-11 .token.attr-value { - color: #69f0ae; - } - body.dark .code-0-0-11 .token.plain-text { - color: #bdbdbd; - } - body.dark .code-0-0-11 .token.script { - color: #e0e0e0; - } - body.dark .code-0-0-11 .token.placeholder { - color: #18ffff; - } - body.dark .code-0-0-11 .token.selector { - color: #ffa372; - } - body.dark .code-0-0-11 .token.property { - color: #f6d186; - } - body.dark .code-0-0-11 .token.important { - color: #be79df; - } - body.dark .code-0-0-11.scss .token.function, body.dark .code-0-0-11.css .token.function, body.dark .code-0-0-11.sass .token.function { - color: #9aceff; - } - body.dark .code-0-0-11 .token.key { - color: #f6d186; - } - .lineCounter-0-0-12 { - left: 0; - color: transparent; - width: 24px; - height: 1.25rem; - display: inline-flex; - position: sticky; - font-size: 10px; - background: #212121; - align-items: center; - border-right: 2px solid rgba(255, 255, 255, .015); - margin-right: 12px; - padding-right: 12px; - flex-direction: row-reverse; - vertical-align: top; - } - .lineCounter-0-0-12.prim { - color: #616161; - } -@media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .lineCounter-0-0-12 { - background: #000000; - border-color: rgba(255, 255, 255, .015); - } - body:not(.dark-mode-animate) .lineCounter-0-0-12.prim { - color: #616161; - } -} - body.dark .lineCounter-0-0-12 { - background: #000000; - border-color: rgba(255, 255, 255, .015); - } - body.dark .lineCounter-0-0-12.prim { - color: #616161; - } - .line-0-0-13 { - cursor: pointer; - height: 1.25rem; - display: inline-block; - min-width: 100%; - background: transparent; - transition: opacity .15s; - } - .has-selection .line-0-0-13:not(.selected) { - opacity: 0.35; - transition: opacity 3s; - } - .line-0-0-13.highlight { - color: #ffffff; - background: rgb(40, 46, 73); - } - .line-0-0-13.selected .lineCounter-0-0-12 { - border-color: #7187ff !important; - } - .line-0-0-13:hover, .line-0-0-13.selected { - background: #3b3b3b; - } - .line-0-0-13:hover .lineCounter-0-0-12 { - border-color: rgba(255, 255, 255, .1); - } - body.dark .line-0-0-13:hover .lineCounter-0-0-12 { - border-color: rgba(255, 255, 255, .1); - } - .line-0-0-13:hover .lineCounter-0-0-12, .line-0-0-13.selected .lineCounter-0-0-12 { - color: #7187ff; - background: #3b3b3b !important; - } - body.dark .line-0-0-13:hover, body.dark .line-0-0-13.selected { - background: #1a1a1a !important; - } - body.dark .line-0-0-13:hover .lineCounter-0-0-12, body.dark .line-0-0-13.selected .lineCounter-0-0-12 { - color: #7187ff; - background: #1a1a1a !important; - } - body.dark .line-0-0-13.selected .lineCounter-0-0-12 { - border-color: #7187ff !important; - } - .line-0-0-13.highlight .lineCounter-0-0-12 { - background: rgb(40, 46, 73); - } -@media (prefers-color-scheme: dark) { - body:not(.dark-mode-animate) .line-0-0-13.highlight { - color: #ffffff; - background: rgb(28, 29, 48); - } - body:not(.dark-mode-animate) .line-0-0-13.highlight .lineCounter-0-0-12 { - background: rgb(28, 29, 48); - } -} - body.dark .line-0-0-13.highlight { - color: #ffffff; - background: rgb(28, 29, 48); - } - body.dark .line-0-0-13.highlight .lineCounter-0-0-12 { - background: rgb(28, 29, 48); - } - .wmbar-0-0-14 { - left: 0; - display: none; - padding: 16px; - position: sticky; - } - .wmbar-0-0-14>span { - display: block; - opacity: 0.5; - flex-grow: 1; - font-size: 12px; - text-align: center; - font-family: sans-serif; - margin-right: 64px; - } - .wmbar-0-0-14>span:first-child, .wmbar-0-0-14>span:nth-child(2), .wmbar-0-0-14>span:nth-child(3) { - width: 8px; - height: 8px; - opacity: 1; - flex-grow: 0; - margin-right: 8px; - border-radius: 8px; - } - pre.with-bar .wmbar-0-0-14 { - display: flex; - } - .wmbar-0-0-14>span:first-child:first-child, .wmbar-0-0-14>span:nth-child(2):first-child, .wmbar-0-0-14>span:nth-child(3):first-child { - background: rgb(255, 95, 86); - } - .wmbar-0-0-14>span:first-child:nth-child(2), .wmbar-0-0-14>span:nth-child(2):nth-child(2), .wmbar-0-0-14>span:nth-child(3):nth-child(2) { - background: rgb(255, 189, 46); - } - .wmbar-0-0-14>span:first-child:nth-child(3), .wmbar-0-0-14>span:nth-child(2):nth-child(3), .wmbar-0-0-14>span:nth-child(3):nth-child(3) { - background: rgb(39, 201, 63); - } \ No newline at end of file +} \ No newline at end of file diff --git a/docs/examples.html b/docs/examples.html index 0904068..85525ea 100644 --- a/docs/examples.html +++ b/docs/examples.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link🐣 Examples

linkList all the snapshots for all the backends

1autorestic -a exec snapshots

linkUnlock a locked repository

If you accidentally cancelled a running operation this could be useful.

Only do this if you know what you are doing.

1autorestic -b my-backend exec unlock

🐣 ExamplesList all the snapshots for all the backendsUnlock a locked repository
Star

Created With

link🐣 Examples

linkList all the snapshots for all the backends

1autorestic -a exec snapshots

linkUnlock a locked repository

If you accidentally cancelled a running operation this could be useful.

Only do this if you know what you are doing.

1autorestic -b my-backend exec unlock

🐣 ExamplesList all the snapshots for all the backendsUnlock a locked repository

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 974073c..06d187c 100644 --- a/docs/index.html +++ b/docs/index.html @@ -35,24 +35,24 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkautorestic

High backup level CLI utility for restic.

Autorestic is a wrapper around the amazing restic. While being amazing the restic cli can be a bit overwhelming and difficult to manage if you have many different location that you want to backup to multiple locations. This utility is aimed at making this easier 🙂

+
Star

Created With

linkautorestic

High backup level CLI utility for restic.

Autorestic is a wrapper around the amazing restic. While being amazing the restic cli can be a bit overwhelming and difficult to manage if you have many different location that you want to backup to multiple locations. This utility is aimed at making this easier 🙂

-

link✈️ Roadmap

I would like to make the official 1.0 release in the coming months. Until then please feel free to file issues or feature requests so that the tool is as flexible as possible :)

As of version 0.18 crons are supported wich where the last feature missing for a 1.0. Will test this for a few weeks and then it's time for the first "real" release! 🎉 Also we now have waaay better docs 📒

link🌈 Features

  • YAML config files, no CLI
  • Incremental -> Minimal space is used
  • Backup locations to multiple backends
  • Snapshot policies and pruning
  • Fully encrypted
  • Pre/After hooks
  • Exclude pattern/files
  • Cron jobs for automatic backup
  • Backup & Restore docker volumes
autorestic✈️ Roadmap🌈 Features
autorestic✈️ Roadmap🌈 Features

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -61,4 +61,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/installation.html b/docs/installation.html index c22ee93..224eb01 100644 --- a/docs/installation.html +++ b/docs/installation.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link🛳 Installation

Linux & macOS. Windows is not supported. If you have problems installing please open an issue :)

Autorestic requires curl, wget and bzip2 to be installed. For most systems these should be already installed.

1curl -s https://raw.githubusercontent.com/CupCakeArmy/autorestic/master/install.sh | bash

🛳 Installation
Star

Created With

link🛳 Installation

Linux & macOS. Windows is not supported. If you have problems installing please open an issue :)

Autorestic requires curl, wget and bzip2 to be installed. For most systems these should be already installed.

1curl -s https://raw.githubusercontent.com/CupCakeArmy/autorestic/master/install.sh | bash

🛳 Installation

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/location/cron.html b/docs/location/cron.html index 4285dc1..69c6658 100644 --- a/docs/location/cron.html +++ b/docs/location/cron.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkCron

Often it is usefull to trigger backups autmatically. For this we can specify a cron attribute to each location.

Available since version 0.18

.autorestic.yml
1locations:

2  my-location:

3    from: /data

4    to: my-backend

5    cron: '0 3 * * 0' # Every Sunday at 3:00

Here is a awesome website with some examples and an explorer

linkInstalling the cron

To actually enable cron jobs you need something to call autorestic cron on a timed shedule. Note that the shedule has nothing to do with the cron attribute in each location. My advise would be to trigger the command every 5min, but if you have a cronjob that runs only once a week, it's probably enough to shedule it once a day.

linkCrontab

Here is an example using crontab, but systemd would do too.

First, open your crontab in edit mode

1crontab -e

Then paste this at the bottom of the file and save it. Note that in this specific example the .autorestic.yml is located in /srv/. You need to modify that part of course to fit your config file.

1# This is required, as it otherwise cannot find restic as a command.

2PATH="/usr/local/bin:/usr/bin:/bin"

3

4# Example running every monday at 4 in the morning

50 4 * * 1 autorestic -c /srv/.autorestic.yml cron

Now you can add as many cron attributes as you wish ⏱

CronInstalling the cronCrontab
Star

Created With

linkCron

Often it is usefull to trigger backups autmatically. For this we can specify a cron attribute to each location.

Available since version 0.18

.autorestic.yml
1locations:

2  my-location:

3    from: /data

4    to: my-backend

5    cron: '0 3 * * 0' # Every Sunday at 3:00

Here is a awesome website with some examples and an explorer

linkInstalling the cron

To actually enable cron jobs you need something to call autorestic cron on a timed shedule. Note that the shedule has nothing to do with the cron attribute in each location. My advise would be to trigger the command every 5min, but if you have a cronjob that runs only once a week, it's probably enough to shedule it once a day.

linkCrontab

Here is an example using crontab, but systemd would do too.

First, open your crontab in edit mode

1crontab -e

Then paste this at the bottom of the file and save it. Note that in this specific example the .autorestic.yml is located in /srv/. You need to modify that part of course to fit your config file.

1# This is required, as it otherwise cannot find restic as a command.

2PATH="/usr/local/bin:/usr/bin:/bin"

3

4# Example running every 5 minutes

5*/5 * * * * autorestic -c /srv/.autorestic.yml cron

Now you can add as many cron attributes as you wish ⏱

CronInstalling the cronCrontab

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/location/docker.html b/docs/location/docker.html index 75ceefe..4745fe2 100644 --- a/docs/location/docker.html +++ b/docs/location/docker.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkDocker

autorestic supports docker volumes directly, without needing them to be mounted to the host filesystem.

Available since version 0.13

Let see an example.

docker-compose.yml
1version: '3.7'

2

3volumes:

4  data:

5    name: my-data

6

7services:

8  api:

9    image: alpine

10    volumes:

11      - data:/foo/bar

.autorestic.yml
1locations:

2  hello:

3    from: 'volume:my-data'

4    to:

5      - remote

6    options:

7      forget:

8        keep-last: 14 # Useful for limitations explained belowd

9

10backends:

11  remote: ...

Now you can backup and restore as always.

1autorestic -l hello backup

1autorestic -l hello restore

If the volume does not exist on restore, autorestic will create it for you and then fill it with the data.

linkLimitations

Unfortunately there are some limitations when backing up directly from a docker volume without mounting the volume to the host:

  1. Incremental updates are not possible right now due to how the current docker mounting works. This means that it will take significantely more space.
  2. Exclude patterns and files also do not work as restic only sees a compressed tarball as source and not the actual data.

If you are curious or have ideas how to improve this, please read more here. Any help is welcomed 🙂

DockerLimitations
Star

Created With

linkDocker

autorestic supports docker volumes directly, without needing them to be mounted to the host filesystem.

Available since version 0.13

Let see an example.

docker-compose.yml
1version: '3.7'

2

3volumes:

4  data:

5    name: my-data

6

7services:

8  api:

9    image: alpine

10    volumes:

11      - data:/foo/bar

.autorestic.yml
1locations:

2  hello:

3    from: 'volume:my-data'

4    to:

5      - remote

6    options:

7      forget:

8        keep-last: 14 # Useful for limitations explained belowd

9

10backends:

11  remote: ...

Now you can backup and restore as always.

1autorestic -l hello backup

1autorestic -l hello restore

If the volume does not exist on restore, autorestic will create it for you and then fill it with the data.

linkLimitations

Unfortunately there are some limitations when backing up directly from a docker volume without mounting the volume to the host:

  1. Incremental updates are not possible right now due to how the current docker mounting works. This means that it will take significantely more space.
  2. Exclude patterns and files also do not work as restic only sees a compressed tarball as source and not the actual data.

If you are curious or have ideas how to improve this, please read more here. Any help is welcomed 🙂

DockerLimitations

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/location/exclude.html b/docs/location/exclude.html index e875e88..adebfbc 100644 --- a/docs/location/exclude.html +++ b/docs/location/exclude.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkExcluding files

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 so you can use any flag used there.

1locations:

2  my-location:

3    from: /data

4    to: my-backend

5    options:

6      backup:

7        exclude:

8          - '*.nope'

9          - '*.abc'

10        exclude-file: .gitignore

Excluding files
Star

Created With

linkExcluding files

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 so you can use any flag used there.

1locations:

2  my-location:

3    from: /data

4    to: my-backend

5    options:

6      backup:

7        exclude:

8          - '*.nope'

9          - '*.abc'

10        exclude-file: .gitignore

Excluding files

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/location/forget.html b/docs/location/forget.html index fad9524..f9ab901 100644 --- a/docs/location/forget.html +++ b/docs/location/forget.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkForget/Prune Policies

Autorestic supports declaring snapshot policies for location to avoid keeping old snapshot around if you don't need them.

This is based on Restic's snapshots policies, and can be enabled for each location as shown below:

Note This is a full example, of course you also can specify only one of them

.autorestic.yml
1locations:

2  etc:

3    from: /etc

4    to: local

5    options:

6      forget:

7        keep-last: 5 # always keep at least 5 snapshots

8        keep-hourly: 3 # keep 3 last hourly shapshots

9        keep-daily: 4 # keep 4 last daily shapshots

10        keep-weekly: 1 # keep 1 last weekly shapshots

11        keep-monthly: 12 # keep 12 last monthly shapshots

12        keep-yearly: 7 # keep 7 last yearly shapshots

13        keep-within: '2w' # keep snapshots from the last 2 weeks

Forget/Prune Policies
Star

Created With

linkForget/Prune Policies

Autorestic supports declaring snapshot policies for location to avoid keeping old snapshot around if you don't need them.

This is based on Restic's snapshots policies, and can be enabled for each location as shown below:

Note This is a full example, of course you also can specify only one of them

.autorestic.yml
1locations:

2  etc:

3    from: /etc

4    to: local

5    options:

6      forget:

7        keep-last: 5 # always keep at least 5 snapshots

8        keep-hourly: 3 # keep 3 last hourly shapshots

9        keep-daily: 4 # keep 4 last daily shapshots

10        keep-weekly: 1 # keep 1 last weekly shapshots

11        keep-monthly: 12 # keep 12 last monthly shapshots

12        keep-yearly: 7 # keep 7 last yearly shapshots

13        keep-within: '2w' # keep snapshots from the last 2 weeks

Forget/Prune Policies

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/location/hooks.html b/docs/location/hooks.html index 6f6b19c..5df34bc 100644 --- a/docs/location/hooks.html +++ b/docs/location/hooks.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

linkHooks

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.

.autorestic.yml
1locations:

2  my-location:

3    from: /data

4    to: my-backend

5    hooks:

6      before:

7        - echo "Hello"

8        - echo "Human"

9      after:

10        - echo "kthxbye"

Hooks
Star

Created With

linkHooks

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.

.autorestic.yml
1locations:

2  my-location:

3    from: /data

4    to: my-backend

5    hooks:

6      before:

7        - echo "Hello"

8        - echo "Human"

9      after:

10        - echo "kthxbye"

Hooks

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/location/overview.html b/docs/location/overview.html index 4b0800d..05079f0 100644 --- a/docs/location/overview.html +++ b/docs/location/overview.html @@ -35,23 +35,23 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link🗂 Locations

Locations can be seen as the input to the backup process. Generally this is simply a folder. -The paths can be relative from the config file. A location can have multiple backends, so that the data is secured across multiple servers.

.autorestic.yml
1locations:

2  my-location-name:

3    from: path/to/backup

4    to:

5      - name-of-backend

6      - also-backup-to-this-backend

linkfrom

This is the source of the location.

linkHow are paths resolved?

Paths can be absolute or relative. If relative they are resolved relative to the location of the config file. Tilde ~ paths are also supported for home folder resolution.

linkto

This is einther a single backend or an array of backends. The backends have to be configured in the same config file.

🗂 LocationsfromHow are paths resolved?to
Star

Created With

link🗂 Locations

Locations can be seen as the input to the backup process. Generally this is simply a folder. +The paths can be relative from the config file. A location can have multiple backends, so that the data is secured across multiple servers.

.autorestic.yml
1locations:

2  my-location-name:

3    from: path/to/backup

4    to:

5      - name-of-backend

6      - also-backup-to-this-backend

linkfrom

This is the source of the location.

linkHow are paths resolved?

Paths can be absolute or relative. If relative they are resolved relative to the location of the config file. Tilde ~ paths are also supported for home folder resolution.

linkto

This is einther a single backend or an array of backends. The backends have to be configured in the same config file.

🗂 LocationsfromHow are paths resolved?to

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -60,4 +60,4 @@ The paths can be relative from the config file. A location can have multiple bac Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/md/location/cron.md b/docs/md/location/cron.md index 0e04412..8b877e6 100644 --- a/docs/md/location/cron.md +++ b/docs/md/location/cron.md @@ -34,8 +34,8 @@ Then paste this at the bottom of the file and save it. Note that in this specifi # This is required, as it otherwise cannot find restic as a command. PATH="/usr/local/bin:/usr/bin:/bin" -# Example running every monday at 4 in the morning -0 4 * * 1 autorestic -c /srv/.autorestic.yml cron +# Example running every 5 minutes +*/5 * * * * autorestic -c /srv/.autorestic.yml cron ``` Now you can add as many `cron` attributes as you wish ⏱ diff --git a/docs/qa.html b/docs/qa.html index 50b5703..f6f2deb 100644 --- a/docs/qa.html +++ b/docs/qa.html @@ -35,23 +35,23 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link❓ QA

linkMy config file was moved?

This happens when autorestic needs to write to the config file. This happend e.g. when we are generating a key for you. -Unfortunately during this process formatting and comments are lost. That is why autorestic will place a copy of your old config next to the one we are writing to.

❓ QAMy config file was moved?
Star

Created With

link❓ QA

linkMy config file was moved?

This happens when autorestic needs to write to the config file. This happend e.g. when we are generating a key for you. +Unfortunately during this process formatting and comments are lost. That is why autorestic will place a copy of your old config next to the one we are writing to.

❓ QAMy config file was moved?

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -60,4 +60,4 @@ Unfortunately during this process formatting and comments are lost. That is why Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file diff --git a/docs/quick.html b/docs/quick.html index 4978433..ac93e77 100644 --- a/docs/quick.html +++ b/docs/quick.html @@ -35,22 +35,22 @@ .icon-font.outline { font-family: 'Material Icons Outlined'; } -
Star

Created With

link🚀 Quickstart

linkInstallation

1curl -s https://raw.githubusercontent.com/CupCakeArmy/autorestic/master/install.sh | bash

linkWrite a simple config file

1vim .autorestic.yml

For a quick overview:

.autorestic.yml
1locations:

2  home:

3    from: /home/me

4    to: remote

5

6  important:

7    from: /path/to/important/stuff

8    to:

9      - remote

10      - hdd

11

12backends:

13  remote:

14    type: s3

15    path: 's3.amazonaws.com/bucket_name'

16    AWS_ACCESS_KEY_ID: account_id

17    AWS_SECRET_ACCESS_KEY: account_key

18

19  hdd:

20    type: local

21    path: /mnt/my_external_storage

linkCheck [Optional]

1autorestic check -a

This checks if the config file has any issues. If this is the first time this can take longer as autorestic will setup the backends.

linkBackup

1autorestic backup -a

This will do a backup of all locations.

linkRestore

1autorestic restore -l home --from hdd --to /path/where/to/restore

This will restore the location home from the backend hdd to the given path.

🚀 QuickstartInstallationWrite a simple config fileCheck [Optional]BackupRestore
Star

Created With

link🚀 Quickstart

linkInstallation

1curl -s https://raw.githubusercontent.com/CupCakeArmy/autorestic/master/install.sh | bash

linkWrite a simple config file

1vim .autorestic.yml

For a quick overview:

  • locations can be seen as the inputs and backends the output where the data is stored and backed up.
  • One location can have one or multiple backends for redudancy.
  • One backend can also be the target for multiple locations
.autorestic.yml
1locations:

2  home:

3    from: /home/me

4    to: remote

5

6  important:

7    from: /path/to/important/stuff

8    to:

9      - remote

10      - hdd

11

12backends:

13  remote:

14    type: s3

15    path: 's3.amazonaws.com/bucket_name'

16    AWS_ACCESS_KEY_ID: account_id

17    AWS_SECRET_ACCESS_KEY: account_key

18

19  hdd:

20    type: local

21    path: /mnt/my_external_storage

linkCheck [Optional]

1autorestic check -a

This checks if the config file has any issues. If this is the first time this can take longer as autorestic will setup the backends.

linkBackup

1autorestic backup -a

This will do a backup of all locations.

linkRestore

1autorestic restore -l home --from hdd --to /path/where/to/restore

This will restore the location home from the backend hdd to the given path.

🚀 QuickstartInstallationWrite a simple config fileCheck [Optional]BackupRestore

Home +

Home Quick Start Installation -Configuration

Locationschevron_right

Overview +Configuration

Locationschevron_right

Overview Hooks Excluding Files Forget Policy Cron -Docker Volumes

Backendchevron_right

Overview -Available Backends

CLIchevron_right

Info +Docker Volumes

Backendchevron_right

Overview +Available Backends

CLIchevron_right

Info Check Backup Restore @@ -59,4 +59,4 @@ Exec Install Uninstall -Update

Examples

QA

Contributors

GitHub
\ No newline at end of file +Update

Examples

QA

Contributors

GitHub
\ No newline at end of file