5.7 KiB
hub.docker.com/r/tiredofit/libreoffice-online
Introduction
This will build a container for LibreOffice Online for editing documents in a browser from supported applications
-
This Container uses a customized Debian Linux base which includes s6 overlay enabled for PID 1 Init capabilities, zabbix-agent for individual container monitoring, Cron also installed along with other tools (bash,curl, less, logrotate, nano, vim) for easier management.
-
Configurable Concurrent User and Document Limit (set to generarous values by default)
-
Set features to support autogeneration of TLS certificates/activate reverse proxy support, others..
-
Zabbix Monitoring of Active Documents, Users, Memory Consumed
Authors
Table of Contents
Prerequisites
This image assumes that you are using a reverse proxy such as jwilder/nginx-proxy and optionally the Let's Encrypt Proxy Companion @ https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion, or Traefik in order to serve your pages. However, it will run just fine on it's own if you map appropriate ports.
Installation
Builds of the image are available on Docker Hub and is the recommended method of installation.
If you decide to compile this, it will take quite a few hours.
docker pull tiredofit/libreoffice-online
The following image tags are available:
latest- See most recent versioned tag1.4- Collabora Libreoffice 6.0.30 with Collabora Office Online 4.0.4-11.1- Collabora Libreoffice 5.3.61 with Collabora Office Online 3.4.2.1
Quick Start
-
The quickest way to get started is using docker-compose. See the examples folder for a working docker-compose.yml that can be modified for development or production use.
-
Set various environment variables to understand the capabilities of this image. A Sample
docker-compose.ymlis provided that will work right out of the box for most people without any fancy optimizations. -
Map persistent storage for access to configuration and data files for backup.
Configuration
Persistent Storage
The following directories should be mapped for persistent storage in order to utilize the container effectively.
| Folder | Description |
|---|---|
/var/log/loolwsd |
Log files |
/assets/custom |
If you want to update the theme of LibreOffice online, dropping files in here will overwrite /opt/lool/share on startup |
/etc/loolwsd/certs |
(Optional) If you would like to use your own certificates, map this volume and set appropriate variables |
Environment Variables
Along with the Environment Variables from the Base image, below is the complete list of available options that can be used to customize your installation.
| Parameter | Description |
|---|---|
ADMIN_USER |
User for accessing Administration Console - Default admin |
ADMIN_PASS |
Password for accessing Administration Console - Default libreoffice |
ALLOWED_HOSTS |
Set which domains which can access service - Example: ^(.*)\.example\.org |
DICTIONARIES |
Spell Check Languages - Available en_GB en_US - Default en_GB en_US |
LOG_LEVEL |
Log Level - Available none, fatal, critical, error, warning, notice, information, debug, trace - Default warning |
ENABLE_TLS |
Enable TLS - Default: TRUE |
ENABLE_TLS_CERT_GENERATE |
Enable Self Signed Certificate Generation (Default: TRUE) |
ENABLE_TLS_REVERSE_PROXY |
If using a Reverse SSL terminating proxy in front of this container (Default: FALSE) |
TLS_CERT_PATH |
TLS certificates path - Default: /etc/loolwsd/certs |
TLS_CA_FILENAME |
TLS CA Cert filename with extension - Default: ca-chain-cert.pem |
TLS_CERT_FILENAME |
TLS Certificate filename with extension - Default: cert.pem |
TLS_KEY_FILENAME |
TLS Private Key filename with extension - Default: key.pem |
EXTRA_OPTIONS |
If you want to pass additional arguments upon startup, add it here |
Networking
The following ports are exposed.
| Port | Description |
|---|---|
9980 |
Libreoffice Web Services |
Maintenance
Shell Access
For debugging and maintenance purposes you may want access the containers shell.
docker exec -it (whatever your container name is e.g. libreoffice-online) bash