diff --git a/README.md b/README.md index 8d9e77e..33bf7e3 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,11 @@ vaultik config set s3.secret_access_key "..." vaultik snapshot list ``` +For an rclone destination, the storage credentials are in rclone's config file +instead. Copy that file to the new host, or recreate it with `rclone config`, +and set `storage_url` to the original `rclone://remote/path`. See +[storage backends](#storage-backends). + `snapshot list` reads the destination store without the private key. A snapshot that is not in this host's (empty) local index is shown as remote-only: its row is identified by `` rather than by a `hostname_name_timestamp` @@ -281,6 +286,8 @@ work as written. the key is not typed into your shell history. - `VAULTIK_CONFIG`: Path to config file (overridden by `--config`) - `VAULTIK_INDEX_PATH`: Override local SQLite index path +- `RCLONE_CONFIG`: Path to the rclone config file used by an `rclone://` + destination (default `~/.config/rclone/rclone.conf`) - `VAULTIK_CPUPROFILE`: Write a CPU profile to this path for the duration of the run (development/debugging) - `VAULTIK_MEMPROFILE`: Write a heap profile to this path when the run exits @@ -602,11 +609,15 @@ only `vaultik-destination.txt` stops such a backup, and only while the local index holds snapshots. **Rclone** (`rclone://remote/path`): Uses rclone's 70+ supported cloud -providers. Requires rclone to be configured separately (`rclone config`). The -path after the remote name is relative: rclone resolves it on the remote, for -example against the login directory on sftp. A second slash makes it absolute, -as in `rclone://remote//srv/backup`. A remote of type `local` needs an absolute -path; a relative one is refused. +providers. `remote` is the name of a remote in rclone's config file, which holds +that remote's credentials. vaultik reads the same file the `rclone` tool reads, +by default `~/.config/rclone/rclone.conf`. Create it with `rclone config`, or +copy it from another machine; vaultik does not need the `rclone` tool once the +file exists. The `RCLONE_CONFIG` environment variable names a different file. +The path after the remote name is relative: rclone resolves it on the remote, +for example against the login directory on sftp. A second slash makes it +absolute, as in `rclone://remote//srv/backup`. A remote of type `local` needs an +absolute path; a relative one is refused. An upload cut off part-way leaves nothing under the object's name on S3, which shows an object only once its upload has completed, and on the local filesystem