Create and Set Your Backblaze B2 API Credentials

4 min read

Currently the new backup system is BETA only. 

Please do not rely on Beta Backups V2 for your production websites. By running these backups you are agreeing to also maintain separate comprehensive third-party backups of all sites with Backups V2 enabled.

Any ticket submitted for a website with a Backups v2 issue will be treated primarily as a bug report and there is no critical/urgent support or support guarantees.

Activating V2 Backups

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:

Here, click through to the Integrations page, click Backup Providers, and enter your API details in the Backblaze tab:

  1. Give your key a name.
  2. Your KeyID = Account ID
  3. Your applicationKey = API Key
  4. 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.

Further Reading

For further information about how backup systems work, the available options for configuring them, and for setting up remote backups (available on V2), please see the articles listed below.

Strategy

Recommended Backup Strategy

V2 Backups

V1 Backups