Euro-Office Integration for OpenCloud

Warning

The Euro-Office project is currently in its early stages and may or may not break.

The currently working digest for the Document Server is: ghcr.io/euro-office/documentserver:latest@sha256:8e78211dd45407c92d5f60193ecb3f23be371fd3a359a65bef2f9310f09b3d0b

This repository provides the Euro-Office integration for the opencloud-compose deployment.

Prerequisites

• A working opencloud-compose setup.

Installation

1. Clone this repository

Clone this repo into the root of your opencloud-compose project directory:

cd /path/to/opencloud-compose
git clone <euro-office-opencloud-repo-url> euro-office-opencloud

2. Add the required volume

In the main docker-compose.yml, add the following volume to the opencloud service so that the Euro-Office app registry is loaded:

volumes:
  - ./euro-office-opencloud/config/opencloud/app-registry.yaml:/etc/opencloud/app-registry.yaml

3. Configure the .env file

Add the following settings to your .env file:

### EuroOffice Settings ###
# Domain for EuroOffice. Defaults to "euro-office.opencloud.test".
EURO_OFFICE_DOMAIN=
# Domain for the wopiserver which handles EuroOffice. Defaults to "wopiserver-eo.opencloud.test".
EURO_OFFICE_WOPISERVER_DOMAIN=
# EuroOffice JWT_SECRET
EURO_OFFICE_JWT_SECRET=
# EuroOffice Docker image. Defaults to "ghcr.io/euro-office/documentserver".
EURO_OFFICE_DOCKER_IMAGE=
# EuroOffice Docker tag. Defaults to "latest".
EURO_OFFICE_DOCKER_TAG=

4. Configure CSP

In the main opencloud-compose project, add the following entries to config/opencloud/csp.yaml:

frame-src

- 'https://${EURO_OFFICE_DOMAIN|euro-office.opencloud.test}${TRAEFIK_PORT_HTTPS}/'

img-src

- 'https://${EURO_OFFICE_DOMAIN|euro-office.opencloud.test}${TRAEFIK_PORT_HTTPS}/'

5. Update COMPOSE_FILE

Edit the COMPOSE_FILE variable in your .env file to include the Euro-Office compose files:

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

Note: Append euro-office-opencloud/traefik/euro-office.yml:euro-office-opencloud/euro-office.yml to your existing COMPOSE_FILE value if you are combining it with other office integrations.

6. Add local DNS entries (test setup)

If you are using the .test domain (default), add the following entries to your /etc/hosts file:

127.0.0.1 euro-office.opencloud.test
127.0.0.1 wopiserver-eo.opencloud.test

7. Start the services

docker compose up -d