Backups

Backups protect your Odoo data by creating copies of your database and files. If something goes wrong, you can restore your environment to a previous state.

What is a Backup?

A backup is a snapshot of your Odoo environment at a specific point in time. It includes:

• Database - All your business data (customers, orders, invoices, products, etc.)
• Filestore - Uploaded files like documents, images, and attachments

Backups are compressed and stored securely in your configured cloud storage.

Viewing Backups

Environment Backups

View backups for a specific environment:

1. Go to your Project → Environment
2. Click the Backup Management tab
3. See all backups for this environment

Organization Backups Dashboard

View all backups across your organization:

1. Go to Backups in the left sidebar
2. Filter by status, type, or environment
3. Search by environment or project name

This dashboard shows backups from all environments in one place.

Creating a Manual Backup

Create a backup anytime you want to save the current state of your environment.

1. Go to your Environment → Backup Management tab
2. Click the Create Backup button
3. Configure your backup options:
   • Storage Location - Choose where to save the backup
   • Include Filestore - Keep this enabled to include all uploaded files
   • Retention Period - How long to keep the backup (Daily, Weekly, Monthly, Yearly, or Permanent)
4. Click Create Backup
5. Monitor progress in real-time

Tip: Always create a manual backup before making major changes like upgrading Odoo or installing new modules.

Automatic Backups

Set up automatic backups so you never forget to protect your data.

1. Go to your environment's Backup Management tab
2. Click Backup Policy
3. Enable automatic backups with the toggle
4. Set your preferred schedule using presets or cron expression
5. Configure GFS retention (how long to keep backups):
   • Daily backups - Kept for 7 days by default
   • Weekly backups - Kept for 4 weeks by default
   • Monthly backups - Kept for 12 months by default
   • Yearly backups - Kept for 2 years by default
6. Configure notifications (optional):
   • Notify on successful backup
   • Notify on failed backup
7. Save your policy

Once configured, backups run automatically on your schedule.

Backup Types

Restoring from a Backup

Restore your environment to a previous state when needed.

1. Go to your environment's Backup Management tab
2. Find the backup you want to restore
3. Click the Restore button
4. Choose where to restore:
   • Original Environment - Restore to the same environment (rollback)
   • Different Environment - Restore to another compatible environment
   • New Environment - Create a fresh environment from the backup
   • Different Server - Restore to an environment on another server
5. Review the options:
   • Safety backup first - Recommended! Saves current state before restoring
   • Include filestore - Restore uploaded files along with the database
6. Type "RESTORE" to confirm
7. Click Restore Backup and wait for completion

Warning: Restoring replaces all current data with the backup data. Always create a safety backup first.

Downloading a Backup

Download backup files to your computer for external storage or migration.

1. Go to your environment's Backup Management tab
2. Find the backup you want to download
3. Click the download icon
4. Configure download options:
   • URL Expiration: 15 minutes, 30 minutes, 1 hour, 2 hours, or 24 hours
5. Download individual files:
   • Database - backup-{id}-database.sql.gz
   • Filestore - backup-{id}-filestore.tar.gz
   • Manifest - backup-{id}-manifest.json

Download URLs expire after your selected duration for security.

Deleting Old Backups

Remove backups you no longer need to free up storage space.

1. Go to your environment's Backup Management tab
2. Find the backup you want to delete
3. Click the delete icon
4. Confirm the deletion

Note: Backups set to "Permanent" retention will not be automatically deleted. You must delete them manually.

Understanding Backup Status

Completed backups show a verification badge indicating the backup was validated after upload.

Where Backups Are Stored

Backups are saved to cloud storage configured in your organization settings. Supported providers include:

• AWS S3 - Amazon's cloud storage
• Cloudflare R2 - Cost-effective with no download fees
• Backblaze B2 - Low-cost archival storage
• DigitalOcean Spaces - S3-compatible storage
• MinIO - Self-hosted S3-compatible storage
• FTP - Traditional file transfer
• SFTP - Secure file transfer over SSH

Your organization administrator can configure storage providers in Settings → Storage.

Best Practices

1. Enable automatic backups for all production environments
2. Create manual backups before major changes (upgrades, migrations, bulk imports)
3. Test your backups by occasionally restoring to a staging environment
4. Keep multiple retention tiers (daily for quick recovery, monthly for longer history)
5. Always use the safety backup option when restoring
6. Enable notifications to know when backups fail

What's Next?

• Storage Providers - Set up where backups are stored
• Environments - Learn about managing environments
• Migrations - Migrate from other platforms