Create and Set Your Backblaze B2 API Credentials

3 min read

Currently the new backup system is BETA only.

To activate backups 2.0 head to your servers page and click on the name of the server you wish to activate it on.

Warning: This will disable Borg and purge all existing Borg backups from your system. You are responsible for ensuring you have existing backups in place. By enabling Backups v2 you accept full responsibility for this action and confirm you have alternative backups in place. Only enable if you agree to these conditions. Once enabled, this can not be disabled. Borg is going back to the Delta Quadrant.

Backblaze B2 is an inexpensive and reliable cloud storage provider. This article will walk you through to generate a Backblaze API key and add it your GridPane account so that you can use their service for remote website backups.

Step 1. Sign up for a Backblaze account

Head over to https://www.backblaze.com/b2/cloud-storage.html and sign up for an account.

You’ll be asked for your name and email address and then to verify your email address on clicking sign up.

Your first 10GB of storage is free (which is awesome), and after that you’ll need to add a payment method. We recommend you do this immediately to ensure that the transition over 10GB is seamless when the time comes.

Step 2. Create an App Key

In the menu on the left hand side, click through to the App Keys page, and the click to create a new the Add a New Application Key button (you can ignore the master key): The modal as pictured below will open. Here you need to give your key a name and select the Read and Write check box: Next click the “Create New Key” button.

Step 3. Copy your API credentials

Your API credentials will appear on the page. These will only be shown the one time so be sure to copy them before leaving the page.

We need to the: –

  • KeyID
  • applicationKey

Step 4. Add your Backblaze API credentials to GridPane

Back in your GridPane account, click through to your settings page:

And then through to the Backup Providers page and enter your API details.

Your KeyID = Account ID

Your applicationKey = API Key

Click the Create button.

You’re all set! To learn how to configure remote backups for your websites check out the following article for a full walk-through:

Remote Website Backups

Creating Individual Server Buckets without Globally Writeable Permissions

By default, our API uses globally writeable permissions. If you don’t want to give GridPane this level of access, the following can be done instead.

How Buckets Work

Each server has its own unique bucket. This is so that multiple servers don’t have write access to the same bucket, which wouldn’t be ideal in terms of security.

The individual server buckets follow this naming format:

gridpane-backups-${UUID}

The ${UUID} can be found on your server with the following command:

cat /root/gridcreds/gridpane.uuid

The output will look similar to this:

root@nginx:~# cat /root/gridcreds/gridpane.uuid
876ac0ab-690f-4067-bdb6-9b2eec41b989
root@nginx:~#

The bucket name for this server would therefore be:

gridpane-backups-876ac0ab-690f-4067-bdb6-9b2eec41b989

Creating Server Buckets Manually

To create a servers bucket manually, there’s no need for the bucket to be public so keep it set to the default of private. There’s no need to encrypt, as the data is already encrypted on your server, stored encrypted, and transferred encrypted.

  • For the app key name you can use whatever naming convention you prefer.
  • The bucket name you’d use is as stated above and it would need read and write access.
  • Check the Allow List All Bucket Names to allow our API to verify whether or not the bucket already exists so it can create it if it doesn’t (the implementation will change soon so this isn’t necessary, but at the moment it is). A
  • Leave file name prefix and duration empty.

The above is only necessary if this is something you specifically want to do. Otherwise, you can follow steps 1-4 above and leave this to GridPane to create.