OpenProject is the leading open source project management software.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
openproject/docs/user-guide/integrations/nextcloud/README.md

80 lines
3.7 KiB

---
sidebar_navigation:
title: Nextcloud integration
priority: 600
description: Nextcloud and OpenProject integration
robots: index, follow
keywords: integrations, apps, Nextcloud
---
# OpenProject and Nextcloud integration
The OpenProject and Nextcloud integration will improve the productivity of their enterprise users. It combines the strengths of the market leading content collaboration platform Nextcloud and the leading open source project management software OpenProject.
The integration is available starting with Nextcloud 20. It enables users to keep an eye on ongoing project activities directly in their Nextcloud instance.
## Benefits of the integration
The first step of the combined effort is the integration of OpenProject in the Nextcloud dashboard. Users can add an OpenProject widget to display latest changes to project's work packages. With this, it offers users a view of ongoing projects and activities.
## Step by step instructions
The integration is available starting with Nextcloud 20. It enables users to keep an eye on ongoing project activities directly out of their Nextcloud instance.
**Add OpenProject integration app**
To activate your integration to OpenProject in Nextcloud, navigate to the built in app store under your user name in Your apps. You can use the search field in the top right corner to look for the OpenProject integration. Click the button Download and enable.
![Nextcloud_app_store](Nextcloud_app_store.png)
**Activate the OpenProject integration app**
To activate your integration, navigate to your personal settings and choose Connected accounts in the menu on the left.
![Nextcloud_connected_account](Nextcloud_connected_account.png)
Enter the URL of your OpenProject instance and your access token which you can find in OpenProject under My Account and then Access token. Reset the API token and copy/paste it.
![OpenProject_API_key](OpenProject_API_key.png)
![OpenProject_API_key_copy](OpenProject_API_key_copy.png)
**Display of OpenProject in the Nextcloud dashboard**
On the Nextcloud dashboard you can add an OpenProject widget. Display the latest changes to your project's work packages to keep an eye on your ongoing project activities directly from your Nextcloud instance.
![Add_OpenProject_widget](Add_OpenProject_widget.png)
![Nextcloud_dashboard](Nextcloud_dashboard.png)
In your personal settings in Connected accounts, please remember to also activate the Enable navigation link to display a link to your OpenProject instance in the header navigation.
![Nextcloud_connected_account](Nextcloud_connected_account.png)
The link will show here:
![Navigation_link_OpenProject](Navigation_link_OpenProject.png)
By activating "enable unified search for tickets" in your personal settings, the Nextcloud dashboard will include OpenProject information in the the built-in universal search:
![Unified_search](Unified_search.png)
**Set up of OAuth to OpenProject**
Within your Settings under Administration and then Connected Accounts you can set-up the OAuth authentication to your OpenProject instance.
![OAuth](OAuth.png)
In OpenProject, add Nextcloud as application under Administration then Authentication and OAuth and enter the information in your Nextcloud instance.
![OpenProject_OAuth](OpenProject_OAuth.png)
## Where do I find the Nextcloud integration in OpenProject?
Further integration efforts are under way, which will deliver a Nextcloud integration also on the OpenProject side.
## What if project notifications are not displayed?
If the notifications are not displayed in your Nextcloud dashboard, please check the following in your Nextcloud basic settings: in the background jobs, Cron must be activated.
![Cron_job_settings](Cron_job_settings.png)