Skip to content

0.4.1: Cache and keys: The pirate edition

Compare
Choose a tag to compare
@rsdy rsdy released this 31 May 12:40
· 191 commits to master since this release

This release adds a proper caching mechanism, as well as a few better ways to manage your keys.

For the full variety of configuration options, make sure to check out config.toml.example in the repo!

Macos Keychain support

On macOS, you can use the following config snippet to store your keys in Keychain:

[stash.example_keychain]
key = { source = "macos_keychain", user = "[email protected]"}
backend = { type = "fs", path = "/path/to/stash" }

Keyfile

External keyfiles are supported everywhere! Zerostash adds this, so you can copy/paste your config, and provision keyfiles through whatever you need.

[stash.local_keyfile]
key = { source = "file", path = "keyfile.toml.example" }
backend = { type = "fs", path = "/path/to/stash" }

Local file cache

This is probably the most interesting thing. You can create a local cache for all your files in the cloud, so you can quickly update your backups and run queries on files stored locally. Zerostash will automatically keep in the cache the most recently used files and folders, while making sure all the metadata queries stay fast.

You can use it with any kind of upstream, but your local copy needs a directory path.

[stash.remote_cached]
key = { source = "ask" }

[stash.remote_cached.backend]
type = "fs_cache"
path = "/Users/user/Code/repo"
max_size_mb = 1000

[stash.remote_cached.backend.upstream]
type = "s3"
bucket = "test_bucket"
region = { name = "custom", details = { endpoint = "https://127.0.0.1:8080/", "region" = "" }}