Backblaze B2 Cloud Storage works similar to Amazon S3 or Microsoft Azure, allowing you to store unlimited data in the cloud. But does it for 1/4th the cost.
:::{contents} Content :depth: 2 :local: :::
Obtain the login credentials from backblaze.com. Choose App Keys on the sidebar and generate a new application key. Once you have your credentials, choose B2 Cloud Storage from the list of protocols when editing a bookmark or use the b2:// scheme when using the CLI.
- The Master Application Key for an account can be found at the top of the App Keys page of the Backblaze website once you signed in.
- The key for your account has complete access but will become invalid if you generate a new one.
- The key information is only shown when generating the key and is not shown again, so make sure you save the credentials in a secure location if you plan on using this more than once.
Use your Account ID and Master Application Key to log in.
Use your Key ID and Application Key to log in.
:::{tip} Set the Path in the bookmark to the bucket name for application keys restricted to a single bucket. :::
- Use the Backblaze website and sign in to your account
- Click on App Keys in the left-hand menu
- Select Add a New Application Key
- Specify the key settings and permissions and click on Create New Key
- After the Application Key is created, a blue panel is displayed containing the
Key IDandApplication Keyfor the newly generated key.
:::{important} The key information will only appear once. Copy the information somewhere safe for later retrieval. :::
:::{note} Connection profiles can be installed from Preferences → Profiles. :::
The following account regions are available:
- {download}
Download<https://profiles.cyberduck.io/Backblaze%20B2%20(S3%20compatible%20API%20us-west-000).cyberduckprofile>the Backblaze B2 (S3 compatible API us-west-000) Connection Profile for preconfigured settings. - {download}
Download<https://profiles.cyberduck.io/Backblaze%20B2%20(S3%20compatible%20API%20us-west-001).cyberduckprofile>the Backblaze B2 (S3 compatible API us-west-001) Connection Profile for preconfigured settings. - {download}
Download<https://profiles.cyberduck.io/Backblaze%20B2%20(S3%20compatible%20API%20us-west-002).cyberduckprofile>the Backblaze B2 (S3 compatible API us-west-002) Connection Profile for preconfigured settings.
- {download}
Download<https://profiles.cyberduck.io/Backblaze%20B2%20(S3%20compatible%20API%20us-east-005).cyberduckprofile>the Backblaze B2 (S3 compatible API us-east-005) Connection Profile for preconfigured settings.
- {download}
Download<https://profiles.cyberduck.io/Backblaze%20B2%20(S3%20compatible%20API%20eu-central-003).cyberduckprofile>the Backblaze B2 (S3 compatible API eu-central-003) Connection Profile for preconfigured settings.
:::{Attention} Buckets created prior to May 4th, 2020 are not S3 compatible and cannot be accessed :::
You can list all buckets with Cyberduck CLI using
duck --username <application key> --list b2:/
Refer to the Cyberduck CLI documentation for more operations.
Choose File → New Folder to create a new bucket in the root of the browser.
Bucket names, notably:
- must be between 6 and 50 characters long;
- can only consist of alphanumeric characters or "-";
- are case insensitive;
- are globally uniques (i.e. across all Backblaze accounts);
- cannot begin with "b2-" (reserved for Backblaze use).
Setting it to allPrivate means that every download requires an authorization token.
Setting it to allPublic means that everybody is allowed to download the files in the bucket.
You can view all revisions of a file in the browser by choosing View → Show Hidden Files.
A list of file versions can be viewed in the Versions tab of the Info window. Files can be reverted to a chosen version of this list. Additionally, versions of the list can be deleted.
:::{note}
Bucket Versioning has to be enabled within the B2 tab of the Info window before the versions of the files are displayed.
:::
:::{image} _images/B2_tab_info_macOS.png :alt: Backblaze B2 :width: 500px :::
Create an authorized URL to make files available publicly. Choose File → Share…. The shared URL expires in 7 days.
Files larger than 200MB are split into 100MB chunks and uploaded with multiple connections. The number of connections used can be limited using the toggle in the lower right of the transfer window.
Large uploads can be resumed when interrupted.
You can view unfinished large uploads in the browser by choosing View → Show Hidden Files.
If you want to have the SHA1 checksum set in the file info for the large file upload in large_file_sha1 make sure to check Preferences → Transfers → Checksum → Uploads → Verify checksum.
New buckets are private by default, meaning that you need a bucket authorization token to download the files. You can allow public access to files by opening the ACL tab in the Info panel and choose Everyone → Read.
Specify after how many days a file in a bucket should be hidden or deleted.
The number of times a retry attempt is made upon a failure such as 503 Service Unavailable depends on the setting in Preferences → Connection → Repeat failed networking tasks → Number of retries.
Create download shares of files for people with no access to your bucket using File → Share....
The modification date retention is supported using src_last_modified_millis for new files uploaded but without the option to adjust the modification date later.
Supported in Cyberduck 7 or later.