Installation¶
Requirements¶
- Odoo 19.0, Community or Enterprise, with the Project app
- OpenProject 16 or 17, cloud or self-hosted (tested with 16.6 and 17.9)
- outgoing HTTPS from the Odoo server to your OpenProject
- optional, for the webhook: OpenProject must be able to reach your Odoo server over HTTPS
Install the addon¶
- Get the addon for Odoo 19.0: the zip from the Odoo Apps Store, or the one you received from MVdW-Software. For another Odoo version, use the release and the documentation of that version.
-
Extract the zip and copy the directory
openproject_sync_projectto your addons directory.Tip
Keep third-party addons in a custom addons directory, not in the main addons directory.
-
Restart Odoo and make sure the directory is in
addons_path. - Activate developer mode, open Apps, click Update Apps List.
- Search for OpenProject Sync and install OpenProject Sync - Project Tasks (
openproject_sync_project).
Installing changes nothing by itself. It adds Project → Configuration → OpenProject Connectors, an OpenProject tab on tasks, an OpenProject Login field on users and the scheduled action OpenProject: Sync Work Packages.
Upgrade¶
Replace the directory with the new version and update the module:
See the changelog.
Uninstall¶
Apps → OpenProject Sync - Project Tasks → Uninstall. The connectors and the link between tasks and work packages are removed. The tasks, work packages, comments and attachments stay where they are on both sides.
Copies of the database¶
When you duplicate a database for testing (Odoo.sh staging, odoo neutralize, the database manager's Duplicate with
Neutralize), Odoo neutralizes it: every OpenProject connector is archived and set to manual. A test copy then cannot
change the work packages of your live OpenProject. To test the sync on a copy, connect it to a test project in
OpenProject first.