Turn Odoo Into a Document Collaboration Hub with ONLYOFFICE
Last Updated: 6 March 2026
This guide walks you through installing and configuring ONLYOFFICE Docs with Odoo on Ubuntu — enabling real-time document collaboration directly within the Odoo platform. Prefer a guided walkthrough instead? Schedule a free demo with our team and see it in action.
What Is ONLYOFFICE Docs?
ONLYOFFICE Docs is an open-source office suite that includes web-based editors and viewers for:
- Text documents
- Spreadsheets
- Presentations
- Digital forms and fillable templates
- eBooks
- PDF and DJVu files
It supports real-time collaborative editing and includes a ChatGPT plugin for text generation and analysis. ONLYOFFICE Docs integrates with a wide range of third-party platforms, including Odoo, Nextcloud, WordPress, Alfresco, Seafile, and Moodle.
Step 1: Install ONLYOFFICE Docs on Ubuntu
There are several installation options available. The simplest is running ONLYOFFICE Docs as a Docker image. If you prefer not to use Docker, follow the official ONLYOFFICE Docs installation guide to install the latest version of ONLYOFFICE Document Server on Ubuntu.
Step 2: Install the ONLYOFFICE Connector for Odoo
Get the Integration App
Once your ONLYOFFICE Docs and Odoo instances are up and running, you need to install the official ONLYOFFICE integration connector.
Visit the Odoo Marketplace, search for ONLYOFFICE, and download the app for your version of the platform.
Alternatively, the latest version of the connector can be downloaded directly from the GitHub page.

Add the Connector to Odoo
Copy or move the connector folder (onlyoffice_odoo) into your Odoo addons directory:
/…/odoo/addons/
Alternatively, you can register the path by adding the following to your Odoo configuration file (/…/odoo/config/odoo.conf):
[options]
addons_path = /mnt/extra-addons
Make sure to specify the correct path to your addons folder.
Install the PyJWT Library
Run the following command to install the required Python library:
$ pip install pyjwt
Restart and Update Odoo
After installing PyJWT, restart your Odoo instance. Then log in, go to the Apps menu, and click Update Apps List.
Step 3: Configure ONLYOFFICE in Odoo
Go to Settings and open the ONLYOFFICE configuration page. You will see the following fields:
| Field | Description |
|---|---|
| Document Server URL | Enter the URL of your ONLYOFFICE Docs instance. |
| Document Server JWT Secret | A JWT secret key is generated automatically. To use a custom key, enter the same key in your ONLYOFFICE Docs config file. |
| Document Server JWT Header | The default header is Authorisation. Set a custom header if the default conflicts with your server setup. |

What You Can Do After Integration
Once the connector is configured, you can use ONLYOFFICE Docs features directly inside Odoo:
- Open and edit office documents in any part of Odoo where file uploads or attachments are supported.
- Co-edit documents, spreadsheets, presentations, and fillable forms in real time with other Odoo users, using collaborative features such as Fast and Strict co-editing modes, Track Changes, comments, and built-in text chat.
- View PDF files directly within Odoo.
Supported File Formats
The integration fully supports OOXML formats: DOCX, XLSX, and PPTX.
The following formats are also supported for viewing:
DJVU, DOC, DOT, DOTX, EPUB, FB2, HTML, ODT, OTT, RTF, TXT, XPS, XML, CSV, and more.
Ready to Get Started?
Need help setting up ONLYOFFICE with Odoo for your team? Our experts are happy to walk you through it.
"Automate Your Business with our Customized Odoo ERP Solutions"
"Get a Cost Estimate for Your ERP Project, Absolutely FREE!"
Get a Free Quote



