Skip to content

Latest commit

 

History

History
110 lines (73 loc) · 2.73 KB

setup_nc_op__full.md

File metadata and controls

110 lines (73 loc) · 2.73 KB

Nextcloud-OpenProject Full Setup

Table of Contents

  1. Pre-requisites
  2. Run the Setup
  3. Installing Extra Apps
  4. Keycloak Realm Configuration

Pre-requisites

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>

Keycloak Realm Configuration

When the setup is run with Keycloak, new realm will be initialized with necessary clients, permissions, and some demo users. The following are the details:

Realm opnc
Clients nextcloud and openproject (token-exchange has been configured)

And the following are the demo users:

Displayname Username Password
Alice Hansen alice 1234
Brian Murphy brian 1234