autorestic/docs/pages/backend/index.md

# 💽 Backends

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

Note: names of backends MUST be lower case!

```yaml | .autorestic.yml
version: 2

backends:
  name-of-backend:
    type: local
    path: /data/my/backups
```

## Types

We restic supports multiple types of backends. See the [full list](/backend/available) for details.

## Avoid Generating Keys

By default, `autorestic` will generate a key for every backend if none is defined. This is done by updating your config file with the key.

In cases where you want to provide the key yourself, you can ensure that `autorestic` doesn't accidentally generate one for you by setting `requireKey: true`.

Example:

```yaml | .autorestic.yml
version: 2

backends:
  foo:
    type: local
    path: /data/my/backups
    # Alternatively, you can set the key through the `AUTORESTIC_FOO_RESTIC_PASSWORD` environment variable.
    key: ... your key here ...
    requireKey: true
```

With this setting, if a key is missing, `autorestic` will crash instead of generating a new key and updating your config file.
finished docs 5 years ago			`# 💽 Backends`

typos 4 years ago			`Backends are the outputs of the backup process. Each location needs at least one.`
Add line break in documentation 3 years ago
Add lower case warning for backend name If uppercase characters are used in a backend name a check (and I assume other actions) will fail. 3 years ago			`Note: names of backends MUST be lower case!`
finished docs 5 years ago
			```yaml \| .autorestic.yml
docs 3 years ago			`version: 2`

finished docs 5 years ago			`backends:`
			`name-of-backend:`
			`type: local`
			`path: /data/my/backups`
			```

			`## Types`

			`We restic supports multiple types of backends. See the [full list](/backend/available) for details.`
Add option to crash `autorestic` when key is missing instead of generating a new key (#383) * feat(backend): add requireKey option to backend This option will prevent `autorestic` from generating a key and will cause it to crash instead. This is intended for use cases where you want to provision the key yourself and don't want `autorestic` to accidentally generate one for you. * doc(backend): document requireKey 3 months ago
			`## Avoid Generating Keys`

			By default, `autorestic` will generate a key for every backend if none is defined. This is done by updating your config file with the key.

			In cases where you want to provide the key yourself, you can ensure that `autorestic` doesn't accidentally generate one for you by setting `requireKey: true`.

			`Example:`

			```yaml \| .autorestic.yml
			`version: 2`

			`backends:`
			`foo:`
			`type: local`
			`path: /data/my/backups`
			# Alternatively, you can set the key through the `AUTORESTIC_FOO_RESTIC_PASSWORD` environment variable.
			`key: ... your key here ...`
			`requireKey: true`
			```

			With this setting, if a key is missing, `autorestic` will crash instead of generating a new key and updating your config file.