autorestic/docs/markdown/location/options.md

62 lines
1.2 KiB
Markdown
Raw Normal View History

2021-04-30 10:47:29 +02:00
# Options
2021-10-28 18:09:38 +02:00
For the `backup` and `forget` commands you can pass any native flags to `restic`. In addition you can specify flags for every command with `all`.
2021-04-30 10:47:29 +02:00
2021-10-28 18:09:38 +02:00
If flags don't start with `-` they will get prefixed with `--`.
Flags without arguments can be set to `true`. They will be handled accordingly.
> It is also possible to set options for an [entire backend](/backend/options) or globally (see below).
```yaml
locations:
foo:
# ...
options:
all:
some-flag: 123
# Equivalent to
--some-flag: 123
backup:
boolean-flag: true
tag:
- foo
- bar
```
## Example
In this example, whenever `autorestic` runs `restic backup` it will append a `--tag abc --tag` to the native command.
2021-05-17 22:40:23 +02:00
2021-04-30 10:47:29 +02:00
```yaml
locations:
foo:
path: ...
to: ...
options:
backup:
tag:
- foo
- bar
```
2021-10-28 18:09:38 +02:00
## Global Options
2021-04-30 10:47:29 +02:00
2021-10-28 18:09:38 +02:00
It is possible to specify global flags that will be run every time restic is invoked. To do so specify them under `global` in your config file.
```yaml
global:
all:
cache-dir: ~/restic
backup:
tag:
- foo
backends:
# ...
locations:
# ...
```
2021-10-25 18:29:59 +02:00
2021-04-30 10:47:29 +02:00
> :ToCPrevNext