Storage Providers

Storage providers are where your backups are stored. When you create a backup of your Odoo environment, the database and files are saved to your chosen storage provider.

What is a Storage Provider?

A storage provider is a cloud service or server where your backup files are kept safe. You bring your own storage account, which means you have full control and ownership of your backup data.

Supported Providers

OEC.sh supports seven storage providers:

Recommendation: Cloudflare R2 is recommended for most users due to zero download fees and lower storage costs.

Quick Setup from Cloud Accounts

If you have connected cloud accounts (AWS, Cloudflare, DigitalOcean), you can configure storage in seconds 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 method uses your existing cloud account credentials automatically.

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

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 a storage provider, always test the connection:

1. Fill in all the required fields in the storage form
2. Click the Test Connection button
3. Wait a few seconds for the test to complete
4. If successful, you will see a green checkmark
5. If it fails, review the error message and check your credentials

The test verifies that OEC.sh can connect to your storage, create files, read them, and delete them.

Setting a Default Provider

You can set one storage provider as your default. This provider will be automatically 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

The default provider shows a Default badge with a star icon. 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 displays:

• Name and provider type
• Default badge (if set as default)
• Active status indicator (green dot)
• Total size of stored backups
• Object count (number of backup files)
• Linked cloud account indicator (link icon) if 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

Note: You cannot delete a storage provider that has backups stored in it. You must first delete or migrate those backups.

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

What's Next?

• Backups - Learn how to create and manage backups
• Environments - Deploy and manage your Odoo environments