mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-10-31 10:19:09 +00:00
31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# Docker Collabora (DRAFT)
|
||
|
||
## 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.
|
||
|
||
## Further Resources
|
||
|
||
* [Collabora & Talk Super integration demo](https://www.youtube.com/watch?v=7cRmvTyt1ik)
|
||
* [Collabora configuration examples archive](https://cloud.thesysadminhub.com/s/FNKyP43y35HGDTJ?dir=/&openfile=true)
|
||
* [Official Collabora CODE website](https://www.collaboraoffice.com/code/)
|