## Prelude

Using a docker development environment is strongly suggested, due to the very restrictive methods of installing a Nextcloud instance natively. The only way is installing a web server natively and making the Nextcloud repository readable from within the web server directory, including several owning rights configurations.

## Docker

To install docker on your system, please follow the [instructions](https://docs.docker.com/engine/install/) provided by docker itself. You'll need `docker-compose`, too.

After installing docker, clone the [repository](https://github.com/juliushaertl/nextcloud-docker-dev) and follow the instructions in the README. After running the docker-compose, a nextcloud instance will be launched at `http://localhost:8210` with some seeded users. The admin user is `admin:admin`.

#### Podman

There are alternatives to run containers in virtual environments on linux, like [podman](https://podman.io/) if you prefer a non-root executing tool.

## OpenProject Integration in Nextcloud

There is already an integration app for OpenProject available in nextcloud. To enable it, follow the step described [here](https://www.techrepublic.com/article/how-to-add-openproject-integration-into-nextcloud/)

Hint: This guide only enables the link with a users API key. It is also possible to connect to an OAuth2 provider app configured in OpenProject. The settings to do so are located in nextcloud "Settings > Administration > Connected Accounts".

## Comments from Frank

I've got Nextcloud running based on the Docker installation as described in the GitHub page: [https://github.com/nextcloud/integration\_openproject](https://github.com/nextcloud/integration_openproject)

The instructions more or less work, but there were a few issues. Please see my quick notes ("OpenProject\_Nextcloud\_YYYY\_MM\_DD.odp") attached below for the corrections.

In particular these notes include the fixes to the Nextcloud PHP code to make the Nextcloud -> OP integration work (thank to Wieland!).