RESTIC(1)

💖 NAME 💖

restic — backup and restore files, bestie. that's it. that's the whole vibe.

this page lives in the restic manual, section 1 (general commands), and yeah we're doing this whole thing together, no skimming.

---

✨ SYNOPSIS ✨

restic [flags]

---

🌸 DESCRIPTION 🌸

okay so picture this: restic is a backup program, and the way it works is iconic — it saves multiple revisions of your files and directories inside an encrypted repository, and that repository can live on different backends. different. backends. the versatility?? unmatched.

The full documentation can be found at https://restic.readthedocs.io/ . go read it, i'm literally begging, it's so good.

---

💅 OPTIONS 💅

• --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. she cleans up after herself, queen behavior.
• --compression=auto — compression mode (only available for repository format version 2), one of (auto|off|fastest|better|max) (default: $RESTIC_COMPRESSION)
• -h, --help[=false] — help for restic. when in doubt, ask the girl herself.
• --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. for the girlies who pipe into jq.
• --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. silent but deadly (in a good way).
• -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). two is the limit bestie, don't push it.

🫶 heads up: --insecure-no-password and --insecure-tls both say insecure in their own names. that is not a drill. they are genuinely insecure, so know what you're doing before you touch them, okay?

---

🦋 SEE ALSO 🦋

restic-backup(1), restic-cache(1), restic-cat(1), restic-check(1), restic-copy(1), restic-diff(1), restic-dump(1), restic-features(1), restic-find(1), restic-forget(1), restic-generate(1), restic-init(1), restic-key(1), restic-list(1), restic-ls(1), restic-migrate(1), restic-mount(1), restic-options(1), restic-prune(1), restic-recover(1), restic-repair(1), restic-restore(1), restic-rewrite(1), restic-self-update(1), restic-snapshots(1), restic-stats(1), restic-tag(1), restic-unlock(1), restic-version(1)

the whole friend group fr fr 🎀

---

and that's the page!! this beauty was generated by restic generate, and she's been serving since Jan 2017 💖✨ no cap, an icon, a legend, the moment. now go back up your stuff. periodt. 💅🌸