This is a copy od the OpenCloud compose repo for the evaluation to get the Blue Angel for Software.

For dev you can use the run string:

./runner.py --uri PATH_PLEASE_REPLACe/opencloud-compose --name test --allow-unsafe --skip-volume-inspect --dev-no-metrics --dev-no-sleeps --dev-no-phase-stats  --dev-no-optimizations --dev-no-save --skip-system-checks --dev-cache-build --debug

and then

docker exec -it gcb-playwright /bin/bash

to test the scripts.

For the measurments you will need to add --allow-unsafe as we need volumes for the containers to communicate

This repository provides Docker Compose configurations for deploying OpenCloud in various environments.

OpenCloud Compose offers a modular approach to deploying OpenCloud with several configuration options:

• Standard deployment with Traefik reverse proxy and Let's Encrypt certificates
• External proxy support for environments with existing reverse proxies (like Nginx, Caddy, etc.)
• Collabora Online integration for document editing
• Keycloak and LDAP integration for centralized identity management
• Full text search with Apache Tika for content extraction and metadata analysis
• Monitoring with metrics endpoints for observability and performance monitoring

• Docker and Docker Compose installed
• Domain names pointing to your server (for production deployment)
• Basic understanding of Docker Compose concepts

1. Clone the repository:

   git clone https://github.com/opencloud-eu/opencloud-compose.git
   cd opencloud-compose

2. Create environment file:

   cp .env.example .env

   Note: The repository includes .env.example as a template with default settings and documentation. Your actual .env file is excluded from version control (via .gitignore) to prevent accidentally committing sensitive information like passwords and domain-specific settings.

3. Configure deployment options:

   You can deploy using explicit -f flags:

   docker compose -f docker-compose.yml -f traefik/opencloud.yml up -d

   Or by uncommenting the COMPOSE_FILE variable in .env:

   COMPOSE_FILE=docker-compose.yml:traefik/opencloud.yml
   

   Then simply run:

   docker compose up -d

4. Add local domains to /etc/hosts:

   127.0.0.1 cloud.opencloud.test
   127.0.0.1 traefik.opencloud.test
   127.0.0.1 keycloak.opencloud.test
   

5. Access OpenCloud:

   • URL: https://cloud.opencloud.test
   • Username: admin
   • Password: admin (or as configured in .env)

1. Edit the .env file and configure:

   • Domain names
   • Admin password
   • SSL certificate email
   • Storage paths

2. Configure deployment options in .env:

   COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:traefik/opencloud.yml:traefik/collabora.yml
   

3. Start OpenCloud:

   docker compose up -d

OpenCloud can be deployed with Keycloak for identity management and LDAP for the shared user directory:

Using -f flags:

docker compose -f docker-compose.yml -f idm/ldap-keycloak.yml -f traefik/opencloud.yml -f traefik/ldap-keycloak.yml up -d

Or by setting in .env:

COMPOSE_FILE=docker-compose.yml:idm/ldap-keycloak.yml:traefik/opencloud.yml:traefik/ldap-keycloak.yml

Add to /etc/hosts for local development:

127.0.0.1 keycloak.opencloud.test

This setup includes:

• Keycloak for authentication and identity management
• Shared LDAP server as a user directory with demo users and groups
• Integration with Keycloak using OpenCloud clients (web, OpenCloudDesktop, OpenCloudAndroid, OpenCloudIOS)

Include Collabora for document editing using either method:

Using -f flags:

docker compose -f docker-compose.yml -f weboffice/collabora.yml -f traefik/opencloud.yml -f traefik/collabora.yml up -d

Or by setting in .env:

COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:traefik/opencloud.yml:traefik/collabora.yml

Add to /etc/hosts for local development:

127.0.0.1 collabora.opencloud.test
127.0.0.1 wopiserver.opencloud.test

Enable full text search capabilities with Apache Tika using either method:

Using -f flags:

docker compose -f docker-compose.yml -f search/tika.yml -f traefik/opencloud.yml up -d

Or by setting in .env:

COMPOSE_FILE=docker-compose.yml:search/tika.yml:traefik/opencloud.yml

This setup includes:

• Apache Tika for text extraction and metadata analysis from various file formats
• Full text search functionality in the OpenCloud interface
• Support for documents, PDFs, images, and other file types

Enable monitoring capabilities with metrics endpoints using either method:

Using -f flags:

docker compose -f docker-compose.yml -f monitoring/monitoring.yml -f traefik/opencloud.yml up -d

Or by setting in .env:

COMPOSE_FILE=docker-compose.yml:monitoring/monitoring.yml:traefik/opencloud.yml

This setup includes:

• Metrics endpoints for OpenCloud proxy service (port 9205)
• Metrics endpoints for collaboration service (port 9304)
• Performance monitoring and observability data
• Prometheus-compatible metrics format

Access metrics endpoints:

• OpenCloud metrics: http://localhost:9205/metrics
• Collaboration metrics: http://localhost:9304/metrics

Note: The monitoring configuration uses an external network opencloud-net. You need to create this network manually before starting the services:

docker network create opencloud-net

If you already have a reverse proxy (Nginx, Caddy, etc.), use either method:

Using -f flags:

docker compose -f docker-compose.yml -f weboffice/collabora.yml -f external-proxy/opencloud.yml -f external-proxy/collabora.yml up -d

Or by setting in .env:

COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:external-proxy/opencloud.yml:external-proxy/collabora.yml

This exposes the necessary ports:

• OpenCloud: 9200
• Collabora: 9980
• WOPI server: 9300

Please note: If you're using Nginx Proxy Manager (NPM), you should NOT activate "Block Common Exploits" for the Proxy Host. Otherwise, the desktop app authentication will return error 403 Forbidden.

The configuration is managed through environment variables in the .env file:

• We provide .env.example as a template with documentation for all options
• Your personal .env file is ignored by git to keep sensitive information private
• This pattern allows everyone to customize their deployment without affecting the repository

Key variables:

See .env.example for all available options and their documentation.

For production, configure persistent storage:

OC_CONFIG_DIR=/path/to/opencloud/config
OC_DATA_DIR=/path/to/opencloud/data

Ensure proper permissions:

mkdir -p /path/to/opencloud/{config,data}
chown -R 1000:1000 /path/to/opencloud

This repository uses a modular approach with multiple compose files:

• docker-compose.yml - Core OpenCloud service
• weboffice/ - Web office integrations (Collabora Online)
• storage/ - Storage backend configurations (decomposeds3)
• search/ - Search and content analysis services (Apache Tika)
• monitoring/ - Monitoring and metrics configurations
• idm/ - Identity management configurations (Keycloak & LDAP)
• traefik/ - Traefik reverse proxy configurations
• external-proxy/ - Configuration for external reverse proxies
• config/ - Configuration files for OpenCloud, Keycloak, and LDAP

The COMPOSE_FILE environment variable is a powerful way to manage complex Docker Compose deployments:

• It uses colons (:) as separators between files (configurable with COMPOSE_PATH_SEPARATOR)
• Files are processed in order, with later files overriding settings from earlier ones
• It allows you to run just docker compose up -d without specifying -f flags
• Perfect for automation, CI/CD pipelines, and consistent deployments

Example configurations:

Production with Collabora:

COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:traefik/opencloud.yml:traefik/collabora.yml

Production with Keycloak and LDAP:

COMPOSE_FILE=docker-compose.yml:idm/ldap-keycloak.yml:traefik/opencloud.yml:traefik/ldap-keycloak.yml

Production with both Collabora and Keycloak/LDAP:

COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:idm/ldap-keycloak.yml:traefik/opencloud.yml:traefik/collabora.yml:traefik/ldap-keycloak.yml

Production with monitoring:

COMPOSE_FILE=docker-compose.yml:monitoring/monitoring.yml:traefik/opencloud.yml

For automated deployments, using the COMPOSE_FILE variable in .env is recommended:

COMPOSE_FILE=docker-compose.yml:weboffice/collabora.yml:traefik/opencloud.yml:traefik/collabora.yml

This allows tools like Ansible or CI/CD pipelines to deploy the stack without modifying the compose files.

You can create custom compose files to override specific settings after creating a custom directory:

mkdir -p custom

Then create a docker-compose.override.yml file in the custom directory with your overrides.

This folder is ignored by git, allowing you to customize your deployment without affecting the repository. This can be useful in scenarios like portainer where the git repository is configured as a stack.

You can for example add custom labels to the OpenCloud service:

services:
  opencloud:
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.opencloud.rule=Host(`cloud.opencloud.test`)"
      - "traefik.http.services.opencloud.loadbalancer.server.port=80"
      - "traefik.http.routers.opencloud.tls.certresolver=my-resolver"

• SSL Certificate Errors: For local development, accept self-signed certificates by visiting each domain directly in your browser.
• Port Conflicts: If you have services already using ports 80/443, use the external proxy configuration.
• Permission Issues: Ensure data and config directories have proper permissions (owned by user/group 1000).

View logs with:

docker compose logs -f

For specific service logs:

docker compose logs -f opencloud

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the GNU General Public License v3 (GPLv3).