Gen3 Admin Backblaze B2 Backup Setup - GT-Edge-AI/GT-AI-OS GitHub Wiki

Backblaze B2 Portable Backup Setup

Connect GT AI OS portable backups (gt3-portable-backup-v1) to a Backblaze B2 bucket.

Keep Backup & Restore β†’ Object storage open in the Control Panel while you work. Configure bucket connection and credentials entirely in the Control Panel β€” no command-line tools or repo scripts.

Quick checklist

  1. Create a B2 bucket and note its name and region.
  2. Create a B2 Application Key (read/write on that bucket only).
  3. On Object storage: provider Backblaze B2 β†’ fill connection fields β†’ paste keys β†’ Save credentials to cluster β†’ enable Backups β†’ Save Object Storage.
  4. On the Backup tab: Test bucket (leave Endpoint CA secret empty).

Before you start

You need Example
B2 bucket name my-gt3-backups (exact name from Backblaze)
B2 region us-west-004 (in the S3 endpoint URL)
Path prefix production (logical folder for this deployment; no / at start or end)

Part 1 β€” Create a B2 bucket (Backblaze console)

  1. Sign in to Backblaze B2 Cloud Storage.
  2. Click Create a Bucket.
  3. Choose a Bucket Name β€” you will type this same name in GT AI OS.
  4. Note the bucket region (for example us-west-004).

Tip: Open the bucket in Backblaze and copy the S3 Endpoint URL shown there β€” you will paste it into GT AI OS.

Part 2 β€” Create an Application Key (Backblaze console)

  1. In Backblaze, go to App Keys (Application Keys).
  2. Click Add a New Application Key.
  3. Name of Key β€” e.g. gt3-backup.
  4. Allow access to Bucket(s) β€” select only your backup bucket.
  5. Type of Access β€” Read and Write.
  6. Click Create New Key.
  7. Copy and save immediately (the secret is shown once):
    • keyID β†’ paste as Application Key ID in GT AI OS (starts with 003…)
    • applicationKey β†’ paste as Application Key secret (may start with K005…)

Optional: Backblaze sometimes shows key ID and secret together. You can paste that into Or paste combined Application Key on the Object storage tab instead of the two fields above.

Do not email or chat these values.

Part 3 β€” Control Panel Object storage

Go to Backup & Restore β†’ Object storage.

Step 1 β€” Provider

Select Backblaze B2.

Step 2 β€” Connection settings

Use the exact labels on the form:

Form field Example Notes
B2 S3 endpoint URL https://s3.us-west-004.backblazeb2.com From Backblaze β†’ your bucket β†’ S3 Endpoint, or https://s3.<region>.backblazeb2.com
B2 bucket name your bucket name Case-sensitive; not the bucket ID
B2 region us-west-004 Must match the region in the endpoint URL
Path prefix in bucket production Groups this deployment’s portable archives

Leave Advanced fields at their defaults unless your installation guide says otherwise.

Step 4 β€” Save B2 credentials to the cluster

Paste Application Key ID and Application Key secret (or the combined key), then click Save credentials to cluster.

GT AI OS writes these into the cluster for backup jobs. They are not stored in Settings JSON.

Step 5 β€” Enable usage and save

  1. Check Backups.
  2. Click Save Object Storage.

Part 4 β€” Test on the Backup tab

  1. Open the Backup tab (link at the bottom of Object storage, or the Backup tab in the workspace).
  2. Leave Endpoint CA secret empty β€” B2 uses public TLS.
  3. Click Test bucket β€” should report success.

Optional: Click Run backup now, then confirm a new row in the portable S3 catalog and objects under {pathPrefix}/portable/ in B2.

If Test bucket fails

Problem What to check
Access denied (403) Application key is Read and Write on the correct bucket only
Wrong endpoint B2 S3 endpoint URL matches Backblaze’s S3 Endpoint for that bucket
Region mismatch B2 region matches the region in the endpoint URL
Credentials not saved Save credentials to cluster completed before Save Object Storage
Timeout Cluster pods can reach the B2 S3 endpoint (network/firewall/DNS from the GT AI OS host)

Where files land in B2

{pathPrefix}/portable/{backupSetId}/gt3-portable-backup-….tar.gz
{pathPrefix}/portable/{backupSetId}/….manifest.json

Test bucket writes a small probe file under {pathPrefix}/gt-ai-os-preflight-….txt.

Related pages

⚠️ **GitHub.com Fallback** ⚠️