RESTIC-FEATURES(1)

💖 restic-features(1) 💖

okay bestie, so this is a page from the restic backup(1) manual — yes the whole thing lives under that header, we don't make the rules 💅 — and it's all about the restic-features command. pull up a chair, we're gonna read it together 🫶

---

✨ NAME ✨

restic-features — print list of feature flags 🎀

---

🌸 SYNOPSIS 🌸

restic features [flags]

---

🦋 DESCRIPTION 🦋

so the features command literally just prints out a list of all the supported feature flags. that's it. that's the job. iconic behaviour honestly 👑

to actually pass feature flags to restic, you set the RESTIC_FEATURES environment variable to something like featureA=true,featureB=false. and listen — if you specify a feature flag that doesn't exist? that's an error. no cap. ❌

now here's the part you actually need to know, because feature flags come in four whole states and they are NOT the same vibe:

• alpha — disabled by default, and it may change in arbitrary ways between restic versions, or get removed entirely. chaotic. unstable. living its truth. 🙈
• beta — enabled by default, but it can still change in minor ways or be removed. it's giving "we're pretty sure but don't quote us" 😌
• stable — always enabled and it cannot be disabled. the flag itself will be removed in a future restic version. it's settled, periodt ✨
• deprecated — always disabled and it cannot be enabled. this flag will also be removed in a future restic version. it's over, we're moving on 💀

---

🔥 EXIT STATUS 🔥

• exit status is 0 if the command was successful 💖
• exit status is 1 if there was any error 😭

---

💅 OPTIONS 💅

• -h, --help[=false] — help for features 🎀

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the ones you get for free from the parent command, bestie. they're all here, every single one:

• --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) 💖

---

and that's the whole page, bestie!! you ate that. go forth and feature-flag responsibly 🫶✨

this lil masterpiece was generated by restic generate, and the date on it is Jan 2017 — vintage, honestly. the source/version line and the date, mentioned here at the end like a cute sign-off, because that's where the footer lived. mwah 💋