| name | odoo-backup-strategy |
| description | Complete Odoo backup and restore strategy: database dumps, filestore backup, automated scheduling, cloud storage upload, and tested restore procedures. |
| risk | safe |
| source | self |
Odoo Backup Strategy
Overview
A complete Odoo backup must include both the PostgreSQL database and the filestore (attachments, images). This skill covers manual and automated backup procedures, offsite storage, and the correct restore sequence to bring a down Odoo instance back online.
When to Use This Skill
- Setting up a backup strategy for a production Odoo instance.
- Automating daily backups with shell scripts and cron.
- Restoring Odoo after a server failure or data corruption event.
- Diagnosing a failed backup or corrupt restore.
How It Works
- Activate: Mention
@odoo-backup-strategy and describe your server environment.
- Generate: Receive a complete backup script tailored to your setup.
- Restore: Get step-by-step restore instructions for any failure scenario.
Examples
Example 1: Manual Database + Filestore Backup
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
DB_NAME="odoo"
DB_USER="odoo"
FILESTORE_PATH="/var/lib/odoo/.local/share/Odoo/filestore/$DB_NAME"
BACKUP_DIR="/backups/odoo"
mkdir -p "$BACKUP_DIR"
pg_dump -U $DB_USER -Fc $DB_NAME > "$BACKUP_DIR/db_$DATE.dump"
tar -czf "$BACKUP_DIR/filestore_$DATE.tar.gz" -C "$FILESTORE_PATH" .
echo "✅ Backup complete: db_$DATE.dump + filestore_$DATE.tar.gz"
Example 2: Automate with Cron (daily at 2 AM)
0 2 * * * /opt/scripts/backup_odoo.sh >> /var/log/odoo_backup.log 2>&1
Example 3: Upload to S3 (after backup)
aws s3 cp "$BACKUP_DIR/db_$DATE.dump" s3://my-odoo-backups/db/
aws s3 cp "$BACKUP_DIR/filestore_$DATE.tar.gz" s3://my-odoo-backups/filestore/
find "$BACKUP_DIR" -type f -mtime +7 -delete
Example 4: Full Restore Procedure
docker compose stop odoo
dropdb -U odoo odoo 2>/dev/null || true
createdb -U odoo odoo
pg_restore -U odoo -d odoo db_YYYYMMDD_HHMMSS.dump
FILESTORE=/var/lib/odoo/.local/share/Odoo/filestore/odoo
rm -rf "$FILESTORE"/*
tar -xzf filestore_YYYYMMDD_HHMMSS.tar.gz -C "$FILESTORE"/
docker compose start odoo
Best Practices
- ✅ Do: Test restores monthly in a staging environment — a backup you've never restored is not a backup.
- ✅ Do: Follow the 3-2-1 rule: 3 copies, 2 different media types, 1 offsite copy (e.g., S3 or a remote server).
- ✅ Do: Back up immediately before every Odoo upgrade — this is your rollback point.
- ✅ Do: Verify backup integrity:
pg_restore --list backup.dump should complete without errors.
- ❌ Don't: Back up only the database without the filestore — all attachments and images will be missing after a restore.
- ❌ Don't: Store backups on the same disk or same server as Odoo — a disk or server failure destroys both.
- ❌ Don't: Run
pg_restore --clean against a non-existent database — always create the database first.
Limitations
- Does not cover Odoo.sh built-in backups — Odoo.sh has its own backup system accessible from the dashboard.
- This script assumes a single-database Odoo setup. Multi-database instances require looping over all databases.
- Filestore path may differ between installations (Docker volume vs. bare-metal). Always verify the path with
odoo-bin shell before running a restore.
- Large filestores (100GB+) may require incremental backup tools like
rsync or restic rather than full tar.gz archives.