Contents x
Integrate JetStream with Backblaze B2
    • Print
    • Dark
      Light
    Contents

    Integrate JetStream with Backblaze B2

      • Print
      • Dark
        Light
      Article summary

      JetStream file transfer software lets remote teams collaborate through digital workflow automation. You can upload and share files through Backblaze B2 Cloud Storage using a private client-server architecture. 

      Enable Backblaze B2

      Before you begin: You must have a Backblaze B2 Cloud Storage account. If you already have a Backblaze account and the left navigation menu contains a B2 Cloud Storage section, your account is already enabled for Backblaze B2.

      1. Sign in to the Backblaze web console.
      2. In the user menu in the upper-right corner of the page, select My Settings.
      3. Under Enabled Products, select the checkbox to enable B2 Cloud Storage.
      4. Review the Terms and Conditions, and click OK to accept them. 

      Create a Bucket

      1. Sign in to the Backblaze web console.
      2. In the left navigation menu under B2 Cloud Storage, click Buckets.
      3. Click Create a Bucket.
      4. Enter a name for your bucket. Bucket names must be at least six characters and globally unique.
        A message is displayed if your bucket name is already in use.
      5. Select a privacy setting: Private or Public. Files that are in a private bucket require authentication to perform an action, for example, downloading. Public buckets do not require authentication so you can easily share files. You can change a bucket's privacy settings at any time.
      6. If applicable, enable a Backblaze B2 server-side encryption key.
      7. Enable Object Lock to restrict a file from being modified or deleted for a specified period of time.
      8. Click Create a Bucket, and copy the value that is in the Endpoint field; you may need this value later.
      9. Click Lifecycle Settings to control how long to keep the files in your new bucket.
      Note
      If this is your first time creating a public bucket, complete the following tasks to ensure that you have the correct permissions to create a public bucket:

      1. Verify your email address.
      2. Have a payment history on file, or use the credit card form to pay a small fee that is credited to your account balance.
      Note
      Copy the S3 endpoint that is displayed for use in another step.

      Create an Application Key

      Application keys control access to your Backblaze B2 Cloud Storage account and the buckets that are contained in your account.
      1. Sign in to the Backblaze web console.
      2. In the left navigation menu under B2 Cloud Storage, click Application Keys.
      3. Click Add a New Application Key, and enter an app key name. Please note: You cannot search an app key by this name; therefore, app key names are not required to be globally unique. Key names are limited to 100 characters and can contain letters, numbers, and "-", but not I18N characters, such as é, à, and ü.
      4. Select All or a specific bucket in the Allow Access to Bucket(s) dropdown menu.
      5. Optionally, select your access type (Read and Write, Read Only, or Write Only).
      6. Optionally, select the Allow List All Bucket Names checkbox (required for the B2 Native API b2_list_buckets and the S3-Compatible API S3 List Buckets operations).
      7. Optionally, enter a file name prefix to restrict application key access only to files with that prefix. Depending on what you selected in step #4, this limits application key access to files with the specified prefix for all buckets or just the selected bucket.
      8. Optionally, enter a positive integer to limit the time, in seconds, before the application key expires. The value must be less than 1000 days (in seconds).
      9. Click Create New Key, and note the resulting keyID and applicationKey values.
      Note
      When you create a new app key, the response contains the actual key string, for example N2Zug0evLcHDlh_L0Z0AJhiGGdY. You can always find the keyID on this page, but for security, the applicationKey appears only once. Make sure you copy and securely save this value elsewhere.

      Set Up JetStream with Backblaze B2

      Before you begin: You must set up a JetStream server instance so that JetStream client applications can send data to your Backblaze B2 buckets. You can think of this as a storage gateway for your users to then store content in your buckets.

      The JetStream server client supports Ubuntu, CentOS, MacOS, and Windows installations. You can follow the guides located here to find details about the installation for each system.

      For this guide, a JetStream server is running on a Linux machine that is hosted within a Backblaze compute partner, Digital Ocean.

      1. In JetStream, select Locations from the upper-right menu, and click New.
      2. Enter the location details.
        1. Enter a name for this location.
        2. Enter the IP address for the server that you are using for JetStream.
        3. Enter the JetStream client's username and password.
        4. Enter the port number for the server. The default value is 8886.
      3. Click Test Connection to test the connection to the server.
      4. Click Config at the bottom of the screen.
      5. On the Server Config screen, click Add Sandbox Mapping.
      6. On the Sandbox Mapping Edit screen, select S3 Bucket as the mapping type.
      7. Enter the mapping details.
        1. Enter a name for this sandbox.
        2. Enter the name of your Backblaze B2 bucket.
        3. Enter your Backblaze B2 key ID.
        4. Enter your Backblaze B2 application key.
        5. Enter your Backblaze B2 endpoint URL (for example, s3.us-west-000.backblazeb2.com).
      8. Click Save.

      Transfer Files with JetStream

      1. In JetStream, click Send & Receive at the top of the screen.
      2. From the dropdown menu below the Send & Receive option, select the server that you set up earlier.
      3. Select the Backblaze B2 sandbox that you set up earlier.
      4. Drag the files that you want to transfer from the left side of the screen to your sandbox on the right side of the screen.
        The Transfer Preview screen appears that shows a preview of the files that will be written to your Backblaze B2 bucket.
      5. Click Start transfer to begin transferring the files to Backblaze B2.

      For more information about using JetStream, see JetStream documentation.

      Was this article helpful?
      Related articles
      What's Next