Wasabi offers S3-compatible cloud storage known for its straightforward pricing and good performance. It is an excellent choice for storing off-site backups for your RunCloud servers. Connecting Wasabi allows you to securely store your server backups externally.

Follow the steps below to configure Wasabi and link it to your RunCloud dashboard.

Step 1: Setting Up Your Wasabi User and API Keys

  1. Access your Wasabi account through the Wasabi console. In the left-hand navigation menu, find and click on “Users“.
  2. Click the “Create User” button to start setting up a dedicated user for RunCloud.
  3. Enter a unique username. Using something like runcloud-backup-access can help you remember its purpose later.
  1. Make sure to select the “Programmatic access (create API key)” option. This type of access automatically generates the API credentials (Access Key ID and Secret Access Key) that RunCloud requires to interact with your Wasabi account.
  1. You can optionally create or assign this user to a specific group within Wasabi for better organization, but it’s not strictly necessary for the RunCloud integration itself. Click “Next” to proceed.
  1. Now, you need to attach specific permission policies to this user. Click “Attach policies directly“. Select the following policies:
    • WasabiReadOnlyAccess: Allows RunCloud to read objects (needed for listing and potentially restoring backups).
    • WasabiWriteOnlyAccess: Allows RunCloud to write objects (needed for uploading new backups).
    • For Automatic Bucket Creation (Optional but Recommended Initially): If you haven’t already created a specific bucket in Wasabi for RunCloud backups and want RunCloud to create one for you, also add these policies:
      • WasabiFullAccess
      • WasabiAdministratorAccess

Security Note: You can remove WasabiFullAccess and WasabiAdministratorAccess after your first successful backup if you prefer to restrict RunCloud’s permissions to only read/write within the designated bucket.

  1. Carefully review the username and the attached policies on the summary screen. Once you are satisfied, click “Create User“.
  1. Wasabi will now display the user’s Access Key ID and Secret Access Key. This is your only chance to see the Secret Access Key. Click the “Download CSV” button immediately and save this file in a very secure location.

Step 2: Connecting Wasabi to RunCloud

  1. Log in to your RunCloud dashboard and go to the “3rd Party Integrations” tab within your workspace settings. Among the available providers, locate the “Wasabi” integration option and click on it.
  1. You will see a form requesting specific details to link your Wasabi account. Fill in the following fields:
    • Label: Enter a descriptive name for this integration (e.g., “My Wasabi Backup Storage”). This label will appear in RunCloud when you select a backup location.
    • Access Key ID: Carefully copy the Access Key ID from the .csv file you downloaded from Wasabi and paste it here.
    • Secret Access Key: Copy the Secret Access Key from the downloaded .csv file and paste it here.
    • Region: Select the specific Wasabi region where your account or intended bucket resides. This must match your Wasabi setup.
    • Bucket Name (Optional): You can enter the exact name of an existing Wasabi bucket you want RunCloud to use. If you leave this blank, RunCloud will attempt to automatically create a new bucket named something like runcloud-backup-ebf76131814 if the API keys you provided have the necessary permissions.
  2. Save the Integration: Double-check all the entered details for accuracy. Once confirmed, click the “Save Integration” to finalize the connection.

    Step 3: Using Your Wasabi Integration

    Your Wasabi integration is now successfully linked to your RunCloud account. You can use it to create or edit a backup schedule for any of your servers within RunCloud.

    When creating a new backup, choose the “External Storage” option. In the dropdown menu, you will see the Label you assigned to your Wasabi integration (e.g., “My Wasabi Backup Storage”). Select it, and RunCloud will automatically send future backups to your configured Wasabi bucket.

    If you have any other questions or need help – please feel free to get in touch with our 24/7 support team. We’re here to help!