mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-11-26 22:56:46 +00:00
Add full ONLYOFFICE integration:
- 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
This commit is contained in:
32
roles/web-svc-onlyoffice/README.md
Normal file
32
roles/web-svc-onlyoffice/README.md
Normal file
@@ -0,0 +1,32 @@
|
||||
# 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)
|
||||
Reference in New Issue
Block a user