| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 2607 |
| Technical Name |
gdrive_storage_sync |
| License | LGPL-3 |
| Website | https://ksrolabs.com |
| Versions | 16.0 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 2607 |
| Technical Name |
gdrive_storage_sync |
| License | LGPL-3 |
| Website | https://ksrolabs.com |
| Versions | 16.0 17.0 18.0 19.0 |
Google Drive Storage Sync for Odoo
Automatically sync your Odoo attachments with Google Drive. Save database space, keep files organized, and access them anywhere—with automatic backup to Drive.
Live overview of the module in action: configuration, syncing, and monitoring.
- Reducing database size
- Centralizing document storage
- Team collaboration
- Compliance & backups
40% Off For Early Customers
Launch pricing is now active for this module. Get full Google Drive sync features, setup support, and future updates at a reduced price.
- Bi-directional sync with conflict handling
- Shared Drive support and queue reliability
- Onboarding wizard, logs, and monitoring views
Claim your 40% discount before the introductory window closes.
What This Module Does
📤 Upload to Google Drive Automatically
When you attach a file in Odoo (Invoice, Sales Order, etc.), it automatically uploads to Google Drive in organized folders. No manual uploads needed.
📥 Pull Files from Google Drive
Files added to Google Drive folders are automatically detected and appear in Odoo as attachments. Work in Drive, see changes in Odoo.
💾 Save Database Space
Choose to remove files from Odoo after uploading (keep only the Drive link). Saves database storage, keeps your DB lean and fast.
🔄 Smart Conflict Handling
If you edit a file in both Odoo and Drive, the system alerts you and lets you choose which version to keep.
💼 Team Drive Support
Works with Google Shared Drives, perfect for team collaboration. Files stay in sync across your team.
⏰ Auto Database Backups
Automatically backs up your entire Odoo database to Google Drive on a schedule. Never lose your data.
🔗 Share Files Easily
Create public or portal-restricted share links for files directly from Odoo. Control who can access what.
📊 File Manager Dashboard
View all synced files in one place. Filter by type, sort by date, open in Drive with one click.
Storage Options (Choose Your Strategy)
📦 Offload (Save Space)
Best for: Large files, archives, compliance.
What happens:
- File uploads to Drive
- Removed from Odoo database
- You see a Drive link instead
🔄 Mirror (Keep Both)
Best for: Files you edit frequently in both systems.
What happens:
- File uploads to Drive
- Copy stays in Odoo
- Both stay synchronized
🔗 Link Only (Manual)
Best for: Manually linking existing Drive files.
What happens:
- No automatic upload
- Store Drive URL only
- Manual linking of files
What If Both Sides Change? (Conflict Handling)
Sometimes a file gets edited in Odoo AND in Google Drive. The system detects this and you choose what to do:
✅ Odoo Wins
The Odoo version overwrites Drive. Simple, predictable.
Good for: Documents primarily edited in Odoo.
☁️ Drive Wins
The Drive version wins. Changes in Google Drive take priority.
Good for: Documents edited in both places.
👤 Manual (Ask Me)
A notification appears. You decide which version to keep.
Good for: Critical documents, audit trails.
Real-World Examples
📄 Accounting Department
Invoices automatically upload to Drive in folders by vendor. Accountant can review PDFs in Drive or Odoo. Monthly backups to Drive for compliance.
🤝 Sales Team
Quotes and contracts auto-upload to Drive. Teams collaborate on edits. When signed, pull PDF back into Odoo as attachment.
👔 HR Department
Employee files (contracts, IDs, certifications) upload to Drive by department. Reduces database bloat. Employees can upload documents that auto-appear in Odoo.
📦 Projects
Project files organize by project/task. Team uploads to Drive, appears in Odoo. Click "Open" to view in Drive. Never leave Odoo.
Setup (5 Steps)
-
Google Cloud Console (5 min)
Enable Google Drive API, create OAuth credentials, set redirect URL. Detailed steps in the Setup Wizard.
-
Install Module
Go to Apps, search "Google Drive Storage Sync", click Install.
-
Run Setup Wizard (2-3 min)
Menu: Google Drive › Setup Wizard. Paste your Google credentials, authorize, pick a root folder.
-
Create Rules
Menu: Google Drive › Setup & Configuration › Sync Rules. Pick a model (Invoice, Sale Order, etc.) and configure.
-
Done! Files Sync Automatically
Attach a file to a matching record. It uploads to Drive in 1-2 minutes. Check Dashboard to monitor.
Access & Permissions
👤 Regular Users
Can:
- Attach files (auto-syncs)
- View File Manager
- View Dashboard
- Resolve conflicts
⚙️ Administrators
Can:
- Configure connections
- Create sync rules
- View logs & backups
- Test connections
⚠️ Common Mistakes to Avoid
The Setup Wizard shows the exact URL to use. Copy it exactly into Google Cloud Console.
If using a Shared Drive (Team Drive), you must enter its ID during setup. Find it in the Drive URL.
If you limit file types too much, normal files won't sync. Leave empty to sync everything unless you have a specific need.
Sync happens every ~2 minutes (configurable). It's not real-time. Give it a minute or two.
By default, deleting a file in Odoo moves it to Drive trash (keeps the file safe). Deleting in Drive doesn't delete in Odoo unless you configured it to.
Where to Find Everything
Once installed, look for the Google Drive menu in your Odoo sidebar:
📊 Dashboard — See sync status, pending jobs, errors
📁 File Manager — Browse all synced files, open/share them
⚡ Conflicts — Resolve files changed in both places
🔧 Setup Wizard — Initial configuration (Admins only)
🔐 Google Drive Connections — Manage Drive accounts (Admins)
📋 Sync Rules — Configure what/where to sync (Admins)
💾 Backups — View database backups (Admins)
📊 Job Queue — Monitor sync operations (Admins)
📋 Technical Details (For Admins)
How It Works
The module uses Google's Drive API to sync files. It stores your Google credentials securely (encrypted). Sync happens in the background every 2-10 minutes via scheduled crons. All data is backed up to Drive automatically.
Security
✓ Google tokens encrypted and never logged
✓ Share links expire and can be revoked
✓ File access follows Odoo permissions
✓ Only managers see connection secrets
Limitations
- OAuth only: Uses user Google accounts (not service accounts)
- Polling: Sync happens on a schedule (~2-10 min), not real-time
- Offloaded files: When removed from Odoo, they only exist in Drive. To restore, use "Drive Wins" conflict policy
- Google Docs: Google Docs/Sheets are not converted to downloadable files
- Uninstall: Uninstalling doesn't delete Drive files (safe, but you must clean up manually)
Performance Notes
Large files use "resumable uploads" for reliability. Sync happens in batches to avoid overloading the database. Expect 2-5 minute latency between attaching a file and it appearing in Drive.
❓ FAQ
Will syncing crash my Odoo if I have millions of files?
No. The module processes files in small batches and uses database locks to avoid conflicts. It is designed for large-scale sync operations.
What if my internet goes down during a sync?
The module retries automatically with exponential backoff. Jobs remain in queue and continue when connection is restored.
Can I use this with a Google Shared Drive (Team Drive)?
Yes. Enable Team Drive support in client settings and enter the Shared Drive ID.
Do I lose files if I uninstall the module?
No. Files in Google Drive stay in Google Drive, and attachments in Odoo stay in Odoo unless manually removed.
How often does it check for changes?
By default, upload queue processing runs every 2 minutes and Drive change fetch runs every 10 minutes. Both schedules are configurable by administrators.
About KSRO Labs
KSRO Labs builds premium modules for the modern enterprise. We work at the intersection of Odoo, cloud ecosystems, and AI - crafting solutions that are production-grade, deeply integrated, and built to last.
We do not build throwaway plugins. We build infrastructure.
KSRO Labs - Connecting Odoo to the world.
Odoo to BI consulting, implementation support, and dashboard building services.
Email: ksrolabs.info@gmail.com
Website: https://ksrolabs.com
Please log in to comment on this module