mirror of
https://github.com/cupcakearmy/autorestic.git
synced 2024-11-17 11:08:09 +01:00
13aa560fda
Fix #332. This adds a new "PreValidate" hook that is executed before checking the backup location. This allows, for example, mounting a remote source to make the directories of the location available. "PreValidate" is added as a new hook to avoid any breakage that might have been caused by changing the behaviour of the "before" hook. Documentataion updates included.
89 lines
1.8 KiB
Markdown
89 lines
1.8 KiB
Markdown
# 🎛 Config File
|
|
|
|
## Path
|
|
|
|
By default autorestic searches for a `.autorestic.yml` file in the current directory, your home folder and your XDG config folder (`~/.config/` by default):
|
|
|
|
- `./.autorestic.yml`
|
|
- `~/.autorestic.yml`
|
|
- `~/.config/autorestic/.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!
|
|
|
|
## Example configuration
|
|
|
|
```yaml | .autorestic.yml
|
|
version: 2
|
|
|
|
locations:
|
|
home:
|
|
from: /home/me
|
|
to: remote
|
|
|
|
important:
|
|
from: /path/to/important/stuff
|
|
to:
|
|
- remote
|
|
- hdd
|
|
|
|
backends:
|
|
remote:
|
|
type: b2
|
|
path: 'myBucket:backup/home'
|
|
env:
|
|
B2_ACCOUNT_ID: account_id
|
|
B2_ACCOUNT_KEY: account_key
|
|
|
|
hdd:
|
|
type: local
|
|
path: /mnt/my_external_storage
|
|
```
|
|
|
|
## Aliases
|
|
|
|
A handy tool for more advanced configurations is to use yaml aliases.
|
|
These must be specified under the global `extras` key in the `.autorestic.yml` config file.
|
|
Aliases allow to reuse snippets of config throughout the same file.
|
|
|
|
The following example shows how the locations `a` and `b` share the same hooks and forget policies.
|
|
|
|
```yaml | .autorestic.yml
|
|
version: 2
|
|
|
|
extras:
|
|
hooks: &foo
|
|
prevalidate:
|
|
- echo "Wake up!"
|
|
before:
|
|
- echo "Hello"
|
|
after:
|
|
- echo "kthxbye"
|
|
policies: &bar
|
|
keep-daily: 14
|
|
keep-weekly: 52
|
|
|
|
backends:
|
|
# ...
|
|
locations:
|
|
a:
|
|
from: /data/a
|
|
to: some
|
|
hooks:
|
|
<<: *foo
|
|
options:
|
|
forget:
|
|
<<: *bar
|
|
b:
|
|
from: data/b
|
|
to: some
|
|
hooks:
|
|
<<: *foo
|
|
options:
|
|
forget:
|
|
<<: *bar
|
|
```
|