Web-svc-collabora Role¶

Description: No description available

Variables¶

author: Kevin Veen-Birkenbach
description: Collabora Online CODE with automated proxy, networking, and environment configuration.
license: Infinito.Nexus NonCommercial License
license_url: https://s.infinito.nexus/license
company: Kevin Veen-Birkenbach

Consulting & Coaching Solutions https://www.veen.world

min_ansible_version: 2.9
platforms: [{‘name’: ‘Linux’, ‘versions’: [‘all’]}]
galaxy_tags: [‘collabora’, ‘docker’, ‘nginx’, ‘office’, ‘wopi’, ‘code’]
repository: https://s.infinito.nexus/code
issue_tracker_url: https://s.infinito.nexus/issues
documentation: https://s.infinito.nexus/code/web-svc-collabora
logo: {‘class’: ‘fa-solid fa-file-code’}

README¶

Collabora¶

Description¶

This Ansible role deploys Collabora Online (CODE) in Docker to enable real-time, in-browser document editing for Nextcloud. It automates the setup of the Collabora CODE container, Nginx reverse proxy configuration, network isolation via Docker networks, and environment variable management.

Overview¶

Dockerized Collabora CODE: Uses the official collabora/code image.
Nginx Reverse Proxy: Configures a public-facing proxy with TLS termination and WebSocket support for /cool/ paths.
Docker Network Management: Creates an isolated /28 subnet for Collabora and connects containers securely.
Environment Configuration: Generates a .env file with domain, credentials, and extra parameters for Collabora’s WOPI server.

Features¶

Automatic creation of a dedicated Docker network for Collabora.
Proxy configuration template for Nginx with long timeouts and WebSocket upgrades.
Customizable domain names and ports via Ansible variables.
Support for SSL termination at the proxy level.
Integration hooks to restart Nginx and recreate Docker Compose stacks on changes.

Documentation¶

See the role’s README.md, task files, and Jinja2 templates in the roles/web-svc-collabora directory for usage examples and variable definitions.