dropbox_filestore

Dropbox Filestore

Offload Odoo attachments to your own Dropbox to shrink the database and keep files safe

v19.0.1.0.0 Abdelfatah Mohammad (AlshayebCo) Admin & Tools

Inherits ir.attachment, overriding create/write/unlink and _compute_datas so files above max_db_size upload to Dropbox and local copies (datas/db_datas/store_fname) are cleared, with reads transparently fetched back. An abstract dropbox client model wraps the official Dropbox SDK with a shared pooled session, OAuth2 refresh-token support, and a retry-with-backoff decorator; credentials live in ir.config_parameter. Three transient wizards handle OAuth onboarding, full-backlog batch migration, and selected-record migration. Settings extend settings; an HTTP/JSON-RPC controller exposes upload/download/test endpoints; a disabled-by-default daily ir.cron verifies-then-purges orphaned local files. Depends on the python 'dropbox' package.

Overview

Odoo databases and servers balloon as PDFs, images, and scanned documents pile up in attachments, driving up backup time and hosting cost. Dropbox Filestore transparently redirects large attachments to your own Dropbox account while Odoo keeps treating them as normal files, so downloads still work everywhere with no change to user habits. A guided OAuth2 wizard connects the account once and then auto-refreshes tokens forever, while a size threshold decides which files move to Dropbox. A migration wizard sweeps the existing backlog out of the database and filesystem in safe batches.

Workflow

Dropbox Oauth Wizard

Start

Authorize

Complete

Migrate Attachments Wizard

Draft

In Progress

Completed

Error

Migrate Selected Attachments Wizard

Ready

Processing

Done

Key Features

Automatically uploads any attachment above a configurable size threshold to Dropbox and clears its local copy.
Guided OAuth2 authorization wizard connects your Dropbox app in a few clicks, with automatic token refresh so the link never silently expires.
Built-in connection test and a live authorization status indicator confirm the link is healthy before you rely on it.
Bulk migration wizard moves existing database and filesystem attachments to Dropbox in resumable batches with a progress log.
Right-click 'Migrate to Dropbox' action on selected attachments, plus a per-file button, for targeted moves.
Files are stored under a configurable folder with checksum-based paths and de-duplicating auto-rename to avoid collisions.
Storage-location badges and filters (Database, File System, Dropbox) plus grouping let you see exactly where every file lives.
Resilient API client with connection pooling, retry-with-backoff on rate limits and server errors, and clear user-facing error messages.
Optional daily cleanup job removes leftover local copies only after verifying the file is safely retrievable from Dropbox.
JSON-RPC and HTTP endpoints expose upload, download, and connection-test for external integrations.

Technical Details

Technical Name	dropbox_filestore
Version	19.0.1.0.0
License	OPL-1
Domain	ADM · Admin & Tools

Security

Configuration, authorization, and migration tools are restricted to Settings/administrator users, while regular internal users get read-only access to the Dropbox client so attachments can still be fetched on demand.

Internal User (base.group_user) — read-only access to the Dropbox client to download attachments Settings / Administration (base.group_system) — full access to the Dropbox client and all migration and OAuth authorization wizards

Audit Log Hide Any Menu User Wise