setup_nc_op__full.md

Nextcloud-OpenProject Full Setup

Pre-requisites:

• Docker
• Docker Compose
• certutil

Run the Setup

1. Add the following line to the /etc/hosts file:

   127.0.0.1	nextcloud.local openproject.local keycloak.local traefik.local

2. Change the directory to the dev folder

   cd dev

3. (Optional) To enable keycloak service, uncomment the following line in the dev/.env file:

   # run keycloak
   KEYCLOAK=:keycloak.yaml

4. Start the services

   docker compose up

5. Once the services are up, add the certificates to the system and browser trust store

   bash ./ssl.sh

   NOTE: Restart the browser after adding the certificates to the trust store.

6. Access the services:

   Nextcloud: nextcloud.local

   OpenProject: openproject.local

   Keycloak: keycloak.local

   Traefik: traefik.local

Installing Extra Apps

By default, integration_openproject app is enabled in Nextcloud. To install other apps, you can clone and build the desired apps in the apps directory.

1. Clone and build the app in the apps directory

   cd apps
   git clone git@github.com:nextcloud/<app>.git
   
   cd <app>
   # build the app

2. Enable the app in Nextcloud

   # integration_openproject/dev
   cd ../../
   
   docker compose exec -u www-data nextcloud php occ a:e <app>

If permission issues occur, you can run the following command:

# <integration_openproject>/dev

docker compose exec nextcloud chown www-data -R custom_apps/<app>