Backups Setup

PikaPods offers incremental backups to an S3-compatible host using Restic. The overview of setting up backups is described in the PikaPods documentation[1]; this guide goes into detail on setting up backups using our preferred storage provider.

Set up S3 bucket

Create the S3 bucket

Restic requires a unique, empty S3 bucket to store the backups. To create a new bucket in Tigris:

  1. Log in to the Tigris console at console.storage.dev.

  2. Check the dropdown with your username in the top right corner, and make sure the Figure13 organization is selected.

  3. Click Buckets in the left menu, and then click Create Bucket.

  4. In the window that appears, fill out the following settings:

    1. Bucket Name: f13-pika-backup-<your pika pod name> (must be lower case characters) (So, if your pod was named F13-ByteStash-01, the bucket name would be f13-pika-backup-f13-bytestash-01.)

    2. Enable Snapshot: off

    3. Public: off

    4. Enable Soft Delete: off

    5. Open Advanced Settings and set the following:

      1. Bucket locations: Global

      2. Storage tiers: Infrequent Access

  5. Click the Create button.

Share the S3 bucket

So that the newly-created bucket isn’t linked solely to your user account, follow these steps to share the bucket with our organization in Tigris.

  1. In the Buckets list, find your newly-created bucket.

  2. Click the three dots to the right of the bucket.

  3. Select Share Bucket.

  4. In the window that opens, click the dropdown menu next to Organization Access - Figure13 and select Editor.

  5. Click Save.

Create an access key

Now, create an access key that PikaPods can use to push backups to the S3 bucket.

  1. Click Access Keys in the left menu.

  2. Click Create New Access Key.

  3. Name the key the same as the bucket name (for example, f13-pika-backup-f13-bytestash-01)

  4. Once the key is created, make note of the Access Key ID and Secret Access Key in the Restic 1Password vault. You can duplicate this 1Password record and change the name and values.

  5. In the Key Created window, click Manage Key Permissions.

  6. Under Bucket Permissions, click in the Add Buckets field and type or select the bucket you just added.

  7. Set the permission level to Editor.

  8. Click Update.

Set up Pika backups

Now that you’ve created the S3 bucket, let’s set up backups through PikaPods.

  1. Log in to PikaPods and go to the My Pods menu.

  2. Find the pod you want to back up.

  3. Click the gear and select Backups.

  4. Fill out the form as follows:

    1. S3 Endpoint: t3.storage.dev

    2. Bucket: <bucket name you created above> (for example, f13-pika-backup-f13-bytestash-01)

    3. S3 Access Key ID: tid_abc123 (replace with the value you created above)

    4. S3 Secret Key: tsec_abc123 (replace with the value you created above)

  5. Check the agreement box and click on Apply.

  6. Trigger your first manual backup by clicking More → Backup.

  7. Wait a few minutes, and then navigate back to → Backups.

  8. Copy the password shown in Repository Password and save it in the Restic 1Password vault. You can duplicate this 1Password record and change the name and values.

  9. Check the date/time shown under Last successful backup and make sure it’s the backup you recently triggered.

  10. Switch Enable daily automated backups to on.

  11. Switch Prune old backups after 60 days to on.

  12. Click Apply.