Overview

Blossom Cloud provides automated database backups for your services. Backups are handled by the Blossom agent running on your servers and can be configured with different frequencies:

  • Hourly
  • Daily
  • Weekly
  • Monthly

Each backup is automatically uploaded to your configured storage provider (S3-compatible storage) and retained according to your backup settings.

Configuration

You can configure backups for each database through the service’s database settings. Navigate to:

  1. Services > Your Service > Databases > Your Database > Backups > Settings

Here you can:

  • Enable/disable automated backups
  • Set backup frequency
  • Configure retention periods
  • Set up S3 storage credentials

Troubleshooting

If you receive a backup failure notification or need to debug backup issues, follow these steps:

1. Check Agent Status

Verify that the Blossom agent is running properly:

cd /blossom/agent/ && docker compose ps

The agent should be in an “Up” state.

2. Review Backup Schedule

Check your backup schedule configuration:

cat /blossom/agent/schedule.yml

Verify that your database’s backup task is listed with the correct schedule.

3. Check Agent Logs

View the agent logs for any errors:

cd /blossom/agent/ && docker compose logs

Look for any error messages or failed backup attempts.

4. Update Agent

If issues persist, try updating the agent:

  1. Navigate to Cluster Settings
  2. Go to the Actions section
  3. Click “Update Agent”

Common Issues

  1. Storage Configuration
    • Verify your S3 credentials are correct
    • Check that the bucket exists and is accessible
    • Ensure proper permissions are set
  2. Agent Issues
    • Confirm the agent has enough disk space
    • Check that the agent can access the database
    • Verify network connectivity to your storage provider
  3. Database Access
    • Ensure the backup user has proper permissions
    • Check that the database is accessible during backup windows