RESTIC-INIT(1)

💖 restic-init(1) — the glow-up ritual 💖

okay bestie, so this is a page from the restic backup(1) manual — yes the title line says backup even though we're talking about init, don't ask, it's a whole thing, the manpage generator is just like that 🙈. Anyway. Sit down, grab a strawberry, and let's make you a repository. 🍓

---

✨ NAME ✨

restic-init — bestie this is the one that starts it all. It initializes a new repository. Brand new baby repo. Iconic.

---

🌸 SYNOPSIS 🌸

restic init [flags]

---

🦋 DESCRIPTION 🦋

The "init" command initializes a new repository.

That's it. That's the whole description. She's short, she's sweet, she's the beginning of everything. No cap. 💅

---

🔥 EXIT STATUS 🔥

• Exit status is 0 if the command was successful. 🎉 slay, you did it.
• Exit status is 1 if there was any error. 😭 not slay, something went wrong.

---

👑 OPTIONS 👑

• --copy-chunker-params[=false] — copy chunker parameters from the secondary repository. lowkey the move when you're working with the copy command. 🫶
• --from-insecure-no-password[=false] — use an empty password for the source repository. and yes bestie, that is insecure, the manpage literally says so, I'm not being dramatic. 💀
• --from-key-hint="" — key ID of key to try decrypting the source repository first. default: $RESTIC_FROM_KEY_HINT. 🔑
• --from-password-command="" — shell command to obtain the source repository password from. default: $RESTIC_FROM_PASSWORD_COMMAND. 🐚
• --from-password-file="" — file to read the source repository password from. default: $RESTIC_FROM_PASSWORD_FILE. 📄
• --from-repo="" — source repository to copy chunker parameters from. default: $RESTIC_FROM_REPOSITORY. 📦
• --from-repository-file="" — file from which to read the source repository location to copy chunker parameters from. default: $RESTIC_FROM_REPOSITORY_FILE. 🗂️
• -h, --help[=false] — help for init. bestie when in doubt, ask for help, it's free. ✨
• --repository-version="stable" — repository format version to use. allowed values are a format version, 'latest' and 'stable'. 👑

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these are the family heirlooms, passed down from the parent command, they show up everywhere. 🧚

• --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. spring cleaning energy. 🧹
• --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, and you must pass this to every single restic command. insecure. it's giving "please don't". 😭
• --insecure-tls[=false] — skip TLS certificate verification when connecting to the repository. also insecure, also giving "please don't". 🙈
• --json[=false] — set output mode to JSON for commands that support it. for the machines. 🤖
• --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. 🤫
• -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) — the main character herself. 👑

---

heads up bestie: --insecure-no-password and --insecure-tls both literally have the word insecure in the name and the manpage calls them insecure too. that's not me being shady, that's just facts. fr fr. 💀

---

and that's the whole page!! 🎀 generated by restic generate, dated Jan 2017 — yeah she's been around a minute, and she still eats. go forth and restic init, bestie, your repo is gonna be gorgeous. periodt. 💅✨🦋