Installation

What Automatic Database Backup requires, how to install it, and how to check the install worked.

Requirements

• Odoo 18.0, Community or Enterprise, on a server you control
• The standard base and mail modules
• For local backups: no external Python packages
• For SFTP backups: paramiko on the Odoo server

Where this module does not belong

• Odoo Online (SaaS) — a module there has no filesystem access, and Odoo backs those databases up itself. Do not buy this for an Odoo Online database.
• Odoo.sh — platform backups already exist. This is useful there only for pushing an additional copy to your own SFTP server.

On-premise

• Copy the folder into your addons path:

   cp -r technovision_database_backup /opt/odoo/custom/

• Restart Odoo:

   sudo systemctl restart odoo

• Enable developer mode, then Apps → Update Apps List.

• Search for Automatic Database Backup and press Activate.

SFTP support (optional)

Only needed if you will use an SFTP destination:

sudo -u odoo /path/to/odoo/venv/bin/pip install paramiko
sudo systemctl restart odoo

Install it into the same Python environment Odoo runs in. A pip install into the system Python while Odoo runs from a virtualenv is the most common reason the library still appears to be missing.

Preparing a backup folder

Create it and give it to the user Odoo runs as:

sudo mkdir -p /var/backups/odoo
sudo chown odoo:odoo /var/backups/odoo
sudo chmod 750 /var/backups/odoo

750 matters. A database backup contains every password hash and every customer record in your system; it should not be world-readable on a shared server.

Do not use a folder inside your Odoo installation or its filestore. An upgrade or a redeploy will wipe it, and the backup will be gone precisely when you go looking for it.

What installation does

• Creates two models, db.backup.destination and db.backup.run.
• Adds a Database Backup menu under Settings, visible to Settings-level users.
• Adds two scheduled actions. The one that takes backups is inactive — you switch it on once a destination exists. The one that prunes old run records is active and harmless.
• Adds a read-only Backup: History Only group.

Nothing is backed up until you configure a destination and enable the scheduled action.

Verifying the install

• Settings → Database Backup → Destinations → New. Point it at your folder and press Test Destination.
• Press Back Up Now. On anything but a large database this takes seconds.
• Check the file exists in the folder and that the run shows a sensible size.
• Then enable Settings → Technical → Automation → Scheduled Actions → Database Backup: Run Destinations and set the time you want.

Upgrading

odoo-bin -d YOUR_DATABASE -u technovision_database_backup --stop-after-init

Your destinations, history and schedule are preserved.

Uninstalling

Apps → Automatic Database Backup → Uninstall.

This removes the destinations, the run history, the menus and the scheduled actions. The backup files themselves are not touched — they are ordinary files in your folder and stay exactly where they are.