Product Guide
Storage Providers
Overview

Storage Providers

Storage providers are where your backups live. You bring your own storage account, so you keep full control and ownership of your backup data.


Supported Providers

OEC.sh supports eight storage providers:

ProviderBest For
AWS S3Teams with existing AWS infrastructure
Azure Blob StorageMicrosoft Azure users
Cloudflare R2Cost-effective storage with free downloads
Backblaze B2Long-term archival at the lowest cost
DigitalOcean SpacesS3-compatible storage with low latency
MinIOSelf-hosted storage for data privacy compliance
FTPLegacy systems and existing FTP infrastructure
SFTPSecure file transfers over SSH

Cloudflare R2 is a good default choice: zero download fees and lower storage costs than most alternatives.


Quick Setup from Cloud Accounts

If you have connected cloud accounts (AWS, Cloudflare, DigitalOcean), you can configure storage without re-entering credentials:

  1. Go to Settings > Storage tab
  2. Look for the Quick Setup from Cloud Accounts section
  3. Click on your cloud account name
  4. Enter the bucket name and region
  5. Click Create

This reuses your existing cloud account credentials.


Adding a Storage Provider Manually

Cloud Storage (S3, R2, B2, Spaces, MinIO)

  1. Go to Settings > Storage tab
  2. Click Add Storage Provider
  3. Choose your provider type from the dropdown
  4. Enter a friendly name for this storage (e.g., "Production Backups")
  5. Fill in the required fields:
    • Access Key ID: Your provider's access key
    • Secret Access Key: Your provider's secret key
    • Bucket Name: The name of your storage bucket
    • Region: The bucket region (e.g., us-east-1, auto)
    • Endpoint URL (B2/MinIO): The S3-compatible endpoint
    • Account ID (R2 only): Found in your R2 dashboard URL
    • Path Prefix (optional): Folder within the bucket (default: backups/)
  6. Click Test Connection to verify your credentials
  7. Click Create Storage Configuration

Azure Blob Storage

Azure Blob Storage supports multiple authentication methods:

  1. Go to Settings > Storage tab
  2. Click Add Storage Provider
  3. Choose Azure Blob Storage
  4. Enter a friendly name
  5. Choose your authentication method:

Option 1: Account Key (Simplest)

  • Storage Account Name: Your Azure storage account name
  • Account Key: Primary or secondary access key from Azure portal
  • Container Name: The blob container to store backups

Option 2: Connection String

  • Connection String: Full connection string from Azure portal
  • Container Name: The blob container to store backups

Option 3: OAuth/Managed Identity

  • Storage Account Name: Your Azure storage account name
  • Container Name: The blob container to store backups
  • Uses Azure CLI credentials or managed identity
  1. Path Prefix (optional): Folder within the container (default: backups/)
  2. Click Test Connection
  3. Click Create Storage Configuration

Go to Azure Portal > Storage Accounts > Your Account > Access Keys to find your storage account name and access keys. Connection strings are in the same section.

FTP/SFTP Storage

  1. Go to Settings > Storage tab
  2. Click Add Storage Provider
  3. Choose FTP or SFTP
  4. Enter a friendly name
  5. Fill in the connection details:
    • Host: Server hostname or IP address
    • Port: Connection port (SFTP default: 22, FTP default: 21)
    • Username: FTP/SFTP user account
    • Password: Account password
    • Base Path: Directory where backups will be stored
    • Passive Mode (FTP only): Enable for firewalled connections
    • Use SSL/TLS (FTP only): Enable for FTPS encrypted connections
  6. Click Test Connection
  7. Click Create Storage Configuration

Testing Your Connection

Before saving, click Test Connection to verify your credentials. The test checks that OEC.sh can connect to your storage, create files, read them, and delete them. A green checkmark confirms everything is working.


Setting a Default Provider

One storage provider can be set as default. It will be pre-selected when creating backups.

  1. Go to Settings > Storage tab
  2. Find the storage provider you want to use as default
  3. Click the star icon or Set as Default button

Only one provider can be the default at a time.


Editing a Storage Provider

  1. Go to Settings > Storage tab
  2. Find the storage provider you want to edit
  3. Click the Edit button (pencil icon)
  4. Update the fields as needed (credentials are optional when editing)
  5. Click Save Changes

Storage Information

Each storage card shows the provider name and type, default badge, active status, total backup size, object count, and whether it was configured via Quick Setup.


Removing a Storage Provider

  1. Go to Settings > Storage tab
  2. Find the storage provider you want to remove
  3. Click the delete icon (trash can)
  4. Confirm the deletion

You cannot delete a storage provider that still has backups stored in it. Delete or move those backups first.


Troubleshooting

Connection test fails

  • Double-check your access key and secret key for typos
  • Verify the bucket or folder exists in your storage account
  • Make sure your credentials have read and write permissions

Cannot delete storage provider

  • Check if there are backups using this storage
  • Delete or move those backups first, then try again

Backups are slow

  • Choose a storage region geographically close to your server
  • Check your server's internet connection speed