mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-11-23 13:35:04 +00:00
Kevin Veen-Birkenbach
28caa495e7
- New web-svc-onlyoffice role (Docker, env, CSP, proxy hooks) - Nextcloud plugin integration with JWT and CSP updates - Custom Nextcloud image with updated CA certificates - Networking and port assignments - Disabled Collabora by default - Enabled ONLYOFFICE by default - Link to conversation for reference: https://chatgpt.com/share/691f49ac-54d8-800f-83c3-60cf8c100183
33 lines
1.8 KiB
Markdown
33 lines
1.8 KiB
Markdown
# OnlyOffice
|
||
|
||
## Description
|
||
|
||
This Ansible role deploys the ONLYOFFICE Document Server in Docker to provide real-time, in-browser editing for documents, spreadsheets, and presentations.
|
||
It automates the setup of the Document Server container, Nginx reverse proxy configuration, network isolation via Docker networks, and environment variable management for secure integration with Nextcloud or other WOPI-compatible platforms.
|
||
|
||
## Overview
|
||
|
||
* **Dockerized ONLYOFFICE Document Server:** Uses the official `onlyoffice/documentserver` image.
|
||
* **Nginx Reverse Proxy:** Configures a public-facing proxy with TLS termination for `/` and internal API calls.
|
||
* **Docker Network Management:** Creates an isolated `/28` subnet for ONLYOFFICE and connects containers securely.
|
||
* **Environment Configuration:** Generates a `.env` file containing domain, credentials, and JWT configuration for secure document editing.
|
||
|
||
## Features
|
||
|
||
* Automatic creation of a dedicated Docker network for ONLYOFFICE.
|
||
* Proxy configuration template for Nginx with long timeouts.
|
||
* Customizable domain names and ports via Ansible variables.
|
||
* Support for SSL/TLS termination at the proxy level.
|
||
* Optional JWT signing for secure communication between Nextcloud and Document Server.
|
||
* 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-onlyoffice` directory for usage examples and variable definitions.
|
||
|
||
## Further Resources
|
||
|
||
* [Official ONLYOFFICE Document Server Documentation](https://helpcenter.onlyoffice.com/server/document/)
|
||
* [Nextcloud → ONLYOFFICE Integration App](https://apps.nextcloud.com/apps/onlyoffice)
|
||
* [ONLYOFFICE Document Server on Docker Hub](https://hub.docker.com/r/onlyoffice/documentserver)
|