Getting started¶
From a new organization to a running sync takes a few minutes. The app's Overview page shows a setup checklist and keeps it until every step is done.
Try it free for 14 days¶
Every organization can start a 14-day free trial of OpenProject Sync: no payment method needed, one trial per organization and app. Start it from the Try now button of the app in the Exact App Center (you sign in with Exact Online and the portal creates your account and organization), or in the portal under Organization → Subscriptions. When the trial runs out, access stops; subscribing during the trial keeps everything and the subscription starts when the trial ends.
A plan can be upgraded at any time under Organization → Subscriptions: the new plan is charged in full and the unused days of the old one are credited back on a credit note.
Prerequisites¶
- An account in the Exact Gateway portal (https://apps.mvdw-software.com/exact/portal/) and an organization with an active OpenProject Sync subscription (subscribed in the portal under Organization → Subscriptions).
- An Exact Online connection for this app: in the portal under Organization → Exact Online connection, choose the OpenProject Sync app and sign in with the Exact account that may read the time, projects and employees of the administrations you want to sync. The same connection page lists the administrations (divisions) that are enabled for this app.
- An OpenProject instance, cloud or self-hosted, reachable from the internet over https, and a user that is a member of the projects to sync.
- Changes (an OpenProject connection, a linked project, people) are made by organization admins, and admin actions require two-factor authentication in the portal. Reading the pages works for every member.
OpenProject requirements¶
- The token's user needs a project role with View work packages, View time entries and Log time on every project you link. The Project admin role has them all.
- Enable the Time and costs module on the project (Project settings → Modules). The time-tracking module alone is not enough: OpenProject only exposes time entries through its API when the project has the costs module.
- To match people automatically, the token's user must be able to see the other members' e-mail addresses: an administrator always can; for a project role add the permission View user email addresses. Without it the people are listed under People and you choose their Exact employee yourself.
Supported OpenProject versions¶
OpenProject Sync works with OpenProject cloud and self-hosted OpenProject. The compatibility suite runs against one release of every supported major:
| OpenProject | Tested release | CI |
|---|---|---|
| 16.x | 16.6.10 | unit, contract and e2e |
| 17.x | 17.9.7 | unit, contract and e2e |
The unit and contract tests exercise the OpenProject API client against every release, and a full sync has been run against real instances of both. The API surface the app uses is stable across these majors. The tested releases are OpenProject Community Edition; the Enterprise edition exposes the same API. Older versions may work, but they are not supported and not tested. Not sure which version you run? OpenProject shows it under Administration → Information.
The four steps, in order:
- Connect Exact Online (once, in the portal);
- Add an OpenProject connection;
- Link your first project;
- Map the people that appear after the first sync.
Connect Exact Online¶
In the portal, open Organization → Exact Online connection and choose the OpenProject Sync app (each app has its own connection). Sign in to Exact Online and choose the administrations to enable.
Per app, per organization
The portal keeps one Exact connection per organization and per app. Data Bridge, GitLab Sync and OpenProject Sync connect separately, so an organization that uses several connects once for each.
Add an OpenProject connection¶
In OpenProject Sync, open OpenProject connections and press Add OpenProject connection.

- Name: anything that recognises the instance, e.g.
OpenProject cloudorour-openproject. - Address: the base URL of the instance, e.g.
https://example.openproject.com, without/api/v3or a project path. A trailing slash is removed for you; onlyhttpsis accepted. - Access token: an API token created in OpenProject, see below.
The button Test and save checks the token against OpenProject before anything is stored; a rejected token is not kept.
Which token to create¶
In OpenProject, open My account → Access tokens and create an API token (the help box in the dialog links straight to that page). An OpenProject API token has no scopes: it acts as the user who created it, so what the sync can see and do is exactly what that user may do.
- Create the token with a user that has the project role described under OpenProject requirements on the projects to sync. A dedicated service user, added as a member of those projects, keeps the sync independent of one person's account.
- To let the app post status comments on work packages, the user also needs the permission to add comments. Without it the hours still sync; only the comments are skipped.
- A token can be revoked in OpenProject at any time; the connection then shows Token refused.
The connection cards¶
Each instance is a card with its status, the token's last four characters (the token itself is never shown again) and the number of linked projects:

| Action | What it does |
|---|---|
| Test | re-checks the token and shows the result on the card (e.g. Connection works as @speeters) |
| Replace token | types the new token into a masked dialog, tests it, and swaps it when it is valid |
| Disconnect | removes the instance; the confirmation lists every linked project that will stop syncing |
Link your first project¶
With a connection in place, open Projects → Sync a project and follow the four steps, that is the whole story, with a screenshot per step.
Map the people¶
After the first sync, the OpenProject users who logged time appear under People. Most are matched to an Exact employee automatically on their e-mail; the rest are flagged until you choose an employee (or Ignore). See People.
When the checklist on the Overview page is fully ticked, it disappears and the page switches to sync health:
