RESTIC-MIGRATE(1)

✨ restic-migrate(1) ✨

okay bestie, this is the page for restic migrate β€” straight out of the restic backup(1) manual family πŸŽ€ so like, yes, the manual name up top says backup, and the footer says backup, but the actual star of the show is restic-migrate. we move.


🌸 NAME 🌸

restic-migrate β€” apply migrations πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

restic migrate [flags] [migration name] [...]

✨ DESCRIPTION ✨

so here's the vibe: the migrate command πŸ‘‘ looks at your repository and figures out which migrations can be applied, then prints you a lil list of the available migration names. no cap.

and if you actually name one or more migrations? boom, those migrations get applied. periodt. πŸ’–


πŸ’€ EXIT STATUS πŸ’€

she tells you exactly how it went:

  • exit status is 0 if the command was successful 🫢
  • exit status is 1 if there was any error 😭
  • exit status is 10 if the repository does not exist
  • exit status is 11 if the repository is already locked
  • exit status is 12 if the password is incorrect

πŸ’… OPTIONS πŸ’…

  • -f, --force[=false] β€” apply a migration a second time. yes bestie, a second time πŸ”₯
  • -h, --help[=false] β€” help for migrate 🌈

πŸ‘‘ OPTIONS INHERITED FROM PARENT COMMANDS πŸ‘‘

these are the ones she got from her parent commands, and honestly? iconic. 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)
heads up bestie: --insecure-no-password and --insecure-tls are literally labeled (insecure) for a reason. main character energy, but like, the risky kind πŸ’€

🌈 SEE ALSO 🌈


and that's the whole page, bestie 🫢 this one was generated by restic generate, dated Jan 2017, and it lives under the restic backup(1) manual name β€” slay, ate, no crumbs left. πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from