NextCloud Connector
Every attachment lands in the right Nextcloud folder — automatically, without a single upload by hand.
The NextCloud Connector links Odoo to your Nextcloud account and files the documents of sales, purchase, invoicing, contacts, products, transfers, employees and leads in the folder structure configured in Cloud Base. A scheduled export uploads new attachments, an optional import brings files dropped into Nextcloud back into the matching record, and every record carries a Documents smart button that opens its folder. The connector speaks WebDAV with its own client; no extra Python package is installed.
Modules in this bundle
This is the main module of the Nextcloud bundle (package: Cloud). It includes:
Features
Scheduled export into the configured folders
The scheduled action Export Attachments in Nextcloud takes every attachment that has no cloud path yet, creates the record's folder tree if needed and uploads the file. The record and the attachment store the path; the Documents smart button opens the folder in Nextcloud.
- Export in batches of a configurable size for large backlogs; each attachment is committed on its own, so an interrupted run resumes where it stopped.
- Duplicates are recognised by checksum and linked to the file already in the cloud.
- Attachment data can be removed from Odoo after the upload to keep the database small.
Files dropped into Nextcloud come back to Odoo
The scheduled action Import Files from the Cloud walks the configured root folder and creates an attachment for every file that Odoo does not know yet, linked to the record whose folder it lies in.
- Scan a colleague's document into the customer folder and it appears on the partner in Odoo.
- Files that were exported from Odoo are recognised and not imported twice.
Your Nextcloud, seen from the record
The folders in Nextcloud mirror the configuration line by line: ERP/Customers/A/Azure_Interior/Documents/2026/ for a partner, one level deeper for its orders, invoices and transfers. Anyone with access to the Nextcloud folder works with the same files, inside or outside Odoo.
- Preview and download in Odoo read the file from Nextcloud when the data was removed locally.
- Deleting an attachment in Odoo deletes the file in Nextcloud only when the setting Allow deleting documents is on.
Lead files follow the customer
When a lead becomes an opportunity or is assigned to a customer, its files move from the lead folder into
- Nothing stays behind in an orphaned lead folder.
- Merging two leads moves the attachments of the resulting opportunity as well.
Folder structure from Cloud Base
The connector uses the folder configuration of Cloud Base: field expressions, A–Z index folders, year and month folders, template files. Configure the structure once, and sales, purchase, invoicing, contacts, products, transfers, employees and leads follow it.
- Check Path on every record compares the configured tree with Nextcloud and creates what is missing.
- Extensions add Enterprise Documents, manufacturing, projects and lots to the same configuration.
No third-party package, timeouts everywhere
The connector talks WebDAV through its own client built on requests, which every Odoo installation already ships. Every request carries a timeout, so a slow Nextcloud never blocks an Odoo worker.
- Tested against Nextcloud 29; any Nextcloud with WebDAV works.
- SSL verification stays on; a self-signed certificate is handled with a CA bundle path instead of switching verification off.
Administration stays in one group
Export and import runs, the folder configuration and the connection settings require the group Cloud Connector / Manager. Regular users see the smart buttons and the cloud path of their records, nothing more.
- Every run and every warning is logged under Settings → Technical → Logging.
- The connector log and the template files are hidden from other users.
Frequently Asked Questions
Which Odoo editions are supported?
The module runs on Odoo Community and Odoo Enterprise, version 16.0 — self-hosted or on Odoo.sh. Odoo Online, the hosted SaaS edition, does not accept apps from the store, so no third-party module can run there.
Which Nextcloud versions work?
Any Nextcloud that offers WebDAV, which is every supported release. The connector was tested against Nextcloud 29. You need a user account with a password or an app password; that account owns the folders.
Does the module need additional Python packages?
No package to install: the connector uses requests, which is part of every Odoo installation. The manifest declares it so Odoo checks its presence. Nothing has to be added to a requirements.txt, on Odoo.sh or self-hosted.
Which dependencies does the module have?
Cloud Base (from this package) and the standard Odoo modules Contacts, CRM, Sales, Purchase, Invoicing, Inventory, Employees and Discuss. Odoo installs them automatically.
My Nextcloud uses a self-signed certificate. What now?
Enter the path of your CA bundle in the setting REQUESTS_CA_BUNDLE; the connector then verifies the certificate against it. The switch Ignore verification of SSL certificates exists for trusted networks only: without verification the Nextcloud password could be intercepted on the way to the server.
What happens to the attachment in Odoo after the export?
By default the binary data is removed from Odoo and the attachment keeps its cloud path; preview and download read the file from Nextcloud. Switch on Do not delete attachment data in Odoo after export to keep a copy in Odoo.
Can I use Nextcloud and OneDrive at the same time?
One cloud provider per database: install either the NextCloud Connector or the OneDrive Connector on top of Cloud Base. Both use the same folder configuration, so switching later means installing the other connector and running its export once.
Do you provide support?
Yes. Write to support@equitania.de or open a ticket in the support portal at support.equitania.de.
Will it work after an Odoo update within the same major version?
Yes, within Odoo 16.x. A new Odoo major version is delivered as a new module version.
More solutions from Equitania · Weitere Lösungen von Equitania
Support · Kontakt
We are happy to support you · Wir unterstützen Sie gerne.
Weiherstraße 13
75173 Pforzheim
Deutschland · Germany
Telefon: +49 7231 16 604 0
Telefax: +49 7231 16 604 200
Homepage: www.ownerp.com · odoo2fast.report
Support: support.equitania.de
E-Mail: support@equitania.de
EN · All information on this page is provided for product description purposes only and is not legally binding. It constitutes neither a guarantee of quality nor an assurance of any particular scope of functions, fitness for a particular purpose or specific results; only the contractual agreements and the scope of delivery of the version actually installed are authoritative. Screenshots show example configurations. Product and company names mentioned are trademarks or registered trademarks of their respective owners; naming them implies neither affiliation with nor endorsement by those owners. This description was written with AI assistance and was reviewed and approved before publication; the German version prevails.