Skip to main content

Getting started

Bucketree needs one thing before it can show you anything: an application key for your Backblaze B2 account.

Screenshot placeholder: the first-run screen, with the keyID and applicationKey fields empty.

Adding your first key

  1. Sign in to Backblaze and go to Application Keys.
  2. Create a key, or use one you already have.
  3. In Bucketree, paste the keyID and the applicationKey.

Bucketree uses the names Backblaze shows you: keyID, applicationKey, keyName. They are not quite consistent with each other, but they are what is on the screen you just came from.

The key is stored in your Mac's Keychain. Bucketree never writes it to a file, never logs it, and cannot show it back to you afterwards.

Use a scoped key, not the master key

The master key can do everything to your account, including deleting buckets and creating more keys. It is the wrong thing to leave lying around in an app, any app.

Make a key that can do the job in front of you and no more. Bucketree can create keys itself once you are connected, so the master key is only needed once, and you can delete it from the app afterwards.

See Application keys.

What you see first

The sidebar lists your buckets, and three account-level views above them:

ViewShortcutWhat it answers
Buckets⌘1What buckets do I have, and how are they configured
Storage⌘2What am I storing, and what could I stop paying for
Application Keys⌘3What can reach my account, and with what permissions

Screenshot placeholder: the sidebar showing the three account views above a list of buckets.