---
name: "restic-generate"
section: "1"
platform: "linux"
package: "restic"
version: "0.19.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/restic-generate"
---

# restic-generate(1)

Generate manual pages and auto-completion files (bash, fish, zsh, powershell)

## NAME

restic-generate - Generate manual pages and auto-completion files (bash, fish, zsh, powershell)

## SYNOPSIS

**restic generate \[flags\]**

## DESCRIPTION

The "generate" command writes automatically generated files (like the man pages and the auto-completion files for bash, fish, powershell and zsh).

## EXIT STATUS

Exit status is 0 if the command was successful. Exit status is 1 if there was any error.

## OPTIONS

**--bash-completion**=""\
 	write bash completion **file** (**-** for stdout)

**--fish-completion**=""\
 	write fish completion **file** (**-** for stdout)

**-h**, **--help**\[=false\]\
 	help for generate

**--man**=""\
 	write man pages to **directory**

**--powershell-completion**=""\
 	write powershell completion **file** (**-** for stdout)

**--zsh-completion**=""\
 	write zsh completion **file** (**-** for stdout)

## OPTIONS INHERITED FROM PARENT COMMANDS

**--cacert**=\[\]\
 	**file** to load root certificates from (default: use system certificates or $RESTIC\_CACERT)

**--cache-dir**=""\
 	set the cache **directory**. (default: use system default cache directory)

**--cleanup-cache**\[=false\]\
 	auto remove old cache directories

**--compression**=auto\
 	compression mode (only available for repository format version 2), one of (auto\|off\|fastest\|better\|max) (default: $RESTIC\_COMPRESSION)

**--http-user-agent**=""\
 	set a http user agent for outgoing http requests

**--insecure-no-password**\[=false\]\
 	use an empty password for the repository, must be passed to every restic command (insecure)

**--insecure-tls**\[=false\]\
 	skip TLS certificate verification when connecting to the repository (insecure)

**--json**\[=false\]\
 	set output mode to JSON for commands that support it

**--key-hint**=""\
 	**key** ID of key to try decrypting first (default: $RESTIC\_KEY\_HINT)

**--limit-download**=0\
 	limits downloads to a maximum **rate** in KiB/s. (default: unlimited)

**--limit-upload**=0\
 	limits uploads to a maximum **rate** in KiB/s. (default: unlimited)

**--no-cache**\[=false\]\
 	do not use a local cache

**--no-extra-verify**\[=false\]\
 	skip additional verification of data before upload (see documentation)

**--no-lock**\[=false\]\
 	do not lock the repository, this allows some operations on read-only repositories

**-o**, **--option**=\[\]\
 	set extended option (**key=value**, can be specified multiple times)

**--pack-size**=0\
 	set target pack **size** in MiB, created pack files may be larger (default: $RESTIC\_PACK\_SIZE)

**--password-command**=""\
 	shell **command** to obtain the repository password from (default: $RESTIC\_PASSWORD\_COMMAND)

**-p**, **--password-file**=""\
 	**file** to read the repository password from (default: $RESTIC\_PASSWORD\_FILE)

**-q**, **--quiet**\[=false\]\
 	do not output comprehensive progress report

**-r**, **--repo**=""\
 	**repository** to backup to or restore from (default: $RESTIC\_REPOSITORY)

**--repository-file**=""\
 	**file** to read the repository location from (default: $RESTIC\_REPOSITORY\_FILE)

**--retry-lock**=0s\
 	retry to lock the repository if it is already locked, takes a value like 5m or 2h (default: no retries)

**--stuck-request-timeout**=5m0s\
 	**duration** after which to retry stuck requests

**--tls-client-cert**=""\
 	path to a **file** containing PEM encoded TLS client certificate and private key (default: $RESTIC\_TLS\_CLIENT\_CERT)

**-v**, **--verbose**\[=0\]\
 	be verbose (specify multiple times or a level using --verbose=n\`\`, max level/times is 2)

## SEE ALSO

**[restic(1)](/restic/1.md)**