diff options
Diffstat (limited to 'roles/apps/collabora')
26 files changed, 653 insertions, 1973 deletions
diff --git a/roles/apps/collabora/code/contrib/extract-coolwsdxml.sh b/roles/apps/collabora/code/contrib/extract-coolwsdxml.sh index 3f1a2f9e..26496ea7 100755 --- a/roles/apps/collabora/code/contrib/extract-coolwsdxml.sh +++ b/roles/apps/collabora/code/contrib/extract-coolwsdxml.sh @@ -8,7 +8,7 @@ VERSION="$1" IMAGE_TAG="$VERSION" IMAGE_NAME="collabora/code" -CONF_D=$(realpath "${BASH_SOURCE%/*}/../templates/config") +CONF_D=$(realpath "${BASH_SOURCE%/*}/../instance/templates/config") CONTAINER_NAME="collabora-code-coolwsd.xml-extractor" sudo docker rm "$CONTAINER_NAME" > /dev/null 2>&1 diff --git a/roles/apps/collabora/code/contrib/extract-loolwsdxml.sh b/roles/apps/collabora/code/contrib/extract-loolwsdxml.sh deleted file mode 100755 index ab4e5fb4..00000000 --- a/roles/apps/collabora/code/contrib/extract-loolwsdxml.sh +++ /dev/null @@ -1,27 +0,0 @@ -#!/bin/bash - -if [ -z "$1" ]; then - echo "Usage: $0 <version>" - exit 1 -fi -VERSION="$1" - -IMAGE_TAG="$VERSION" -IMAGE_NAME="collabora/code" -CONF_D=$(realpath "${BASH_SOURCE%/*}/../templates/config") -CONTAINER_NAME="collabora-code-loolwsd.xml-extractor" - -sudo docker rm "$CONTAINER_NAME" > /dev/null 2>&1 - -set -e -sudo docker create --name "$CONTAINER_NAME" "$IMAGE_NAME:$IMAGE_TAG" /bin/true -sudo docker cp --archive=false "$CONTAINER_NAME:/etc/loolwsd/loolwsd.xml" - | tar -xO loolwsd.xml > "$CONF_D/loolwsd.$VERSION.xml.j2" -sudo docker rm "$CONTAINER_NAME" - -echo "" -echo "File extraction was sucessful! Now snyc the config file with existing ones." -echo "" -echo "you might also want to delete the image:" -echo "" -echo " sudo docker rmi '$IMAGE_NAME:$IMAGE_TAG'" -echo "" diff --git a/roles/apps/collabora/code/defaults/main.yml b/roles/apps/collabora/code/defaults/main.yml index ef0699c1..932c2168 100644 --- a/roles/apps/collabora/code/defaults/main.yml +++ b/roles/apps/collabora/code/defaults/main.yml @@ -1,22 +1,27 @@ --- -collabora_code_base_path: /srv/collabora/code - # collabora_code_instances: # example: # version: 4.0.6.1 # port: 8200 -# hostname: office.example.com +# storage: +# type: ... +# publish: +# zone: "{{ apps_publish_zone__foo }}" +# hostnames: +# - office.example.com +# tls: +# certificate_provider: ... # admin: # username: admin # password: S3cret -# backend_storages: -# - cloud.example.com -# macros: # optional (by default allowed=false) -# allowed: true -# security_level: 1 -# custom_image: # optional -# from: foo/bar:1.0 # optional -# dockerfile: | -# USER root -# RUN apt-get install ... -# USER 101 +# backend_storages: +# - cloud.example.com +# macros: # optional (by default allowed=false) +# allowed: true +# security_level: 1 +# custom_image: # optional +# from: foo/bar:1.0 # optional +# dockerfile: | +# USER root +# RUN apt-get install ... +# USER 101 diff --git a/roles/apps/collabora/code/filter_plugins/collabora_code.py b/roles/apps/collabora/code/filter_plugins/collabora_code.py deleted file mode 100644 index 2bd6959e..00000000 --- a/roles/apps/collabora/code/filter_plugins/collabora_code.py +++ /dev/null @@ -1,25 +0,0 @@ -from __future__ import (absolute_import, division, print_function) -__metaclass__ = type - -from ansible import errors - - -def collabora_code_loolvcool(version): - try: - ver_maj = version.split('.')[0] - if int(ver_maj) > 6: - return False - return True - except Exception as e: - raise errors.AnsibleFilterError("collabora_code_loolvcool(): %s" % str(e)) - - -class FilterModule(object): - - ''' collabora code filters ''' - filter_map = { - 'collabora_code_loolvcool': collabora_code_loolvcool, - } - - def filters(self): - return self.filter_map diff --git a/roles/apps/collabora/code/instance/tasks/custom-image.yml b/roles/apps/collabora/code/instance/tasks/custom-image.yml new file mode 100644 index 00000000..212fff36 --- /dev/null +++ b/roles/apps/collabora/code/instance/tasks/custom-image.yml @@ -0,0 +1,24 @@ +--- +- name: create build directory for custom image + file: + path: "{{ collabora_code_instance_basepath }}/build" + state: directory + +- name: generate Dockerfile for custom image + copy: + content: | + FROM {{ collabora_code_instances[collabora_code_instance].custom_image.from | default('collabora/code:' + collabora_code_instances[collabora_code_instance].version) }} + {{ collabora_code_instances[collabora_code_instance].custom_image.dockerfile }} + dest: "{{ collabora_code_instance_basepath }}/build/Dockerfile" + register: collabora_code_custom_image_docker + +- name: build custom image + docker_image: + name: "collabora/code/{{ collabora_code_instance }}:{{ collabora_code_instances[collabora_code_instance].version }}" + state: present + force_source: "{{ collabora_code_custom_image_docker is changed }}" + source: build + build: + path: "{{ collabora_code_instance_basepath }}/build" + network: host + pull: yes diff --git a/roles/apps/collabora/code/instance/tasks/main.yml b/roles/apps/collabora/code/instance/tasks/main.yml new file mode 100644 index 00000000..b0470a5b --- /dev/null +++ b/roles/apps/collabora/code/instance/tasks/main.yml @@ -0,0 +1,95 @@ +--- +- name: prepare storage volume + vars: + storage_volume: "{{ collabora_code_instances[collabora_code_instance].storage }}" + include_role: + name: "storage/{{ collabora_code_instances[collabora_code_instance].storage.type }}/volume" + +- set_fact: + collabora_code_instance_basepath: "{{ storage_volume_mountpoint }}" + +- name: create instance config directory + file: + path: "{{ collabora_code_instance_basepath }}/config" + state: directory + mode: 0750 + +- name: generate configuration file + template: + src: "config/coolwsd.{{ collabora_code_instances[collabora_code_instance].version }}.xml.j2" + dest: "{{ collabora_code_instance_basepath }}/config/coolwsd.xml" + +- name: generate/install TLS certificates for publishment + vars: + x509_certificate_name: "collabora-code-{{ collabora_code_instance }}_publish" + x509_certificate_hostnames: [] + x509_certificate_config: + ca: "{{ collabora_code_instances[collabora_code_instance].publish.zone.certificate_ca_config }}" + cert: + common_name: "collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}" + extended_key_usage: + - serverAuth + extended_key_usage_critical: yes + create_subject_key_identifier: yes + not_after: +100w + x509_certificate_renewal: + install: + - dest: "{{ collabora_code_instance_basepath }}/config/ca-chain.cert.pem" + src: + - ca_cert + mode: "0400" + owner: 100 + - dest: "{{ collabora_code_instance_basepath }}/config/cert.pem" + src: + - cert + mode: "0400" + owner: 100 + - dest: "{{ collabora_code_instance_basepath }}/config/key.pem" + src: + - key + owner: 100 + mode: "0400" + include_role: + name: "x509/{{ collabora_code_instances[collabora_code_instance].publish.zone.certificate_provider }}/cert" + +- name: build custom image + when: "'custom_image' in collabora_code_instances[collabora_code_instance]" + include_tasks: custom-image.yml + +- name: install pod manifest + vars: + kubernetes_standalone_pod: + name: "collabora-code-{{ collabora_code_instance }}" + spec: "{{ lookup('template', 'pod-spec.yml.j2') }}" + mode: "0600" + config_hash_items: + - path: "{{ collabora_code_instance_basepath }}/config/coolwsd.xml" + properties: + - checksum + include_role: + name: kubernetes/standalone/pod + +- name: render nginx-vhost custom config + set_fact: + collabora_code_nginx_vhost_custom: "{{ lookup('template', 'nginx-vhost.conf.j2') }}" + +- name: configure nginx vhost for publishment + vars: + nginx_vhost__yaml: | + name: "collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}" + template: generic + {% if 'tls' in collabora_code_instances[collabora_code_instance].publish %} + tls: + {{ collabora_code_instances[collabora_code_instance].publish.tls | to_nice_yaml(indent=2) | indent(2) }} + {% endif %} + hostnames: + {% for hostname in collabora_code_instances[collabora_code_instance].publish.hostnames %} + - {{ hostname }} + {% endfor %} + custom: | + {{ collabora_code_nginx_vhost_custom | indent(2) }} + nginx_vhost: "{{ nginx_vhost__yaml | from_yaml }}" + include_role: + name: nginx/vhost + apply: + delegate_to: "{{ collabora_code_instances[collabora_code_instance].publish.zone.publisher }}" diff --git a/roles/apps/collabora/code/templates/config/coolwsd.21.11.1.3.1.xml.j2 b/roles/apps/collabora/code/instance/templates/config/coolwsd.21.11.1.3.1.xml.j2 index 05e9e3fa..b902dea9 100644 --- a/roles/apps/collabora/code/templates/config/coolwsd.21.11.1.3.1.xml.j2 +++ b/roles/apps/collabora/code/instance/templates/config/coolwsd.21.11.1.3.1.xml.j2 @@ -13,7 +13,7 @@ <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> + <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ collabora_code_instances[collabora_code_instance].publish.hostnames[0] }}</server_name> <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing cool." type="path" relative="true" default="browser/../"></file_server_root_path> <hexify_embedded_urls desc="Enable to protect encoded URLs from getting decoded by intermediate hops. Particularly useful on Azure deployments" type="bool" default="false"></hexify_embedded_urls> @@ -163,8 +163,8 @@ <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> + <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ collabora_code_instances[collabora_code_instance].macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> + <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ collabora_code_instances[collabora_code_instance].macros.security_level | default('1') }}</macro_security_level> <enable_metrics_unauthenticated desc="When enabled, the /cool/getMetrics endpoint will not require authentication." type="bool" default="false">false</enable_metrics_unauthenticated> </security> @@ -191,7 +191,7 @@ <filesystem allow="false" /> <wopi desc="Allow/deny wopi storage." allow="true"> <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} +{% for backend in collabora_code_instances[collabora_code_instance].backend_storages %} <host allow="true">{{ backend }}</host> {% endfor %} <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> @@ -214,8 +214,8 @@ <admin_console desc="Web admin console settings."> <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ item.value.admin.password }}</password> + <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ collabora_code_instances[collabora_code_instance].admin.username }}</username> + <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ collabora_code_instances[collabora_code_instance].admin.password }}</password> </admin_console> <monitors desc="Addresses of servers we connect to on start for monitoring"> diff --git a/roles/apps/collabora/code/templates/config/coolwsd.23.05.5.2.1.xml.j2 b/roles/apps/collabora/code/instance/templates/config/coolwsd.23.05.5.2.1.xml.j2 index 4b002328..7c4a263a 100644 --- a/roles/apps/collabora/code/templates/config/coolwsd.23.05.5.2.1.xml.j2 +++ b/roles/apps/collabora/code/instance/templates/config/coolwsd.23.05.5.2.1.xml.j2 @@ -38,7 +38,7 @@ <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> + <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ collabora_code_instances[collabora_code_instance].publish.hostnames[0] }}</server_name> <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing cool." type="path" relative="true" default="browser/../"></file_server_root_path> <hexify_embedded_urls desc="Enable to protect encoded URLs from getting decoded by intermediate hops. Particularly useful on Azure deployments" type="bool" default="false"></hexify_embedded_urls> <experimental_features desc="Enable/Disable experimental features" type="bool" default="true">true</experimental_features> @@ -194,8 +194,8 @@ <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic and Python scripts to execute both installed and from documents. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> + <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic and Python scripts to execute both installed and from documents. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ collabora_code_instances[collabora_code_instance].macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> + <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ collabora_code_instances[collabora_code_instance].macros.security_level | default('1') }}</macro_security_level> <enable_websocket_urp desc="Should we enable URP (UNO remote protocol) communication over the websocket. This allows full control of the Kit child server to anyone with access to the websocket including executing macros without confirmation or running arbitrary shell commands in the jail." type="bool" default="false">false</enable_websocket_urp> <enable_metrics_unauthenticated desc="When enabled, the /cool/getMetrics endpoint will not require authentication." type="bool" default="false">false</enable_metrics_unauthenticated> </security> @@ -224,7 +224,7 @@ </locking> <alias_groups desc="default mode is 'first' it allows only the first host when groups are not defined. set mode to 'groups' and define group to allow multiple host and its aliases" mode="groups"> -{% for backend in item.value.backend_storages %} +{% for backend in collabora_code_instances[collabora_code_instance].backend_storages %} <group> <host allow="true">https://{{ backend }}:443</host> </group> @@ -245,8 +245,8 @@ <admin_console desc="Web admin console settings."> <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ item.value.admin.password }}</password> + <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ collabora_code_instances[collabora_code_instance].admin.username }}</username> + <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ collabora_code_instances[collabora_code_instance].admin.password }}</password> <logging desc="Log admin activities irrespective of logging.level"> <admin_login desc="log when an admin logged into the console" type="bool" default="true">true</admin_login> <metrics_fetch desc="log when metrics endpoint is accessed and metrics endpoint authentication is enabled" type="bool" default="true">true</metrics_fetch> diff --git a/roles/apps/collabora/code/templates/config/coolwsd.23.05.6.4.1.xml.j2 b/roles/apps/collabora/code/instance/templates/config/coolwsd.23.05.6.4.1.xml.j2 index 4d4ac71c..aaccd7d0 100644 --- a/roles/apps/collabora/code/templates/config/coolwsd.23.05.6.4.1.xml.j2 +++ b/roles/apps/collabora/code/instance/templates/config/coolwsd.23.05.6.4.1.xml.j2 @@ -38,7 +38,7 @@ <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> + <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ collabora_code_instances[collabora_code_instance].publish.hostnames[0] }}</server_name> <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing cool." type="path" relative="true" default="browser/../"></file_server_root_path> <hexify_embedded_urls desc="Enable to protect encoded URLs from getting decoded by intermediate hops. Particularly useful on Azure deployments" type="bool" default="false"></hexify_embedded_urls> <experimental_features desc="Enable/Disable experimental features" type="bool" default="true">true</experimental_features> @@ -209,8 +209,8 @@ <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic and Python scripts to execute both installed and from documents. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> + <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic and Python scripts to execute both installed and from documents. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ collabora_code_instances[collabora_code_instance].macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> + <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ collabora_code_instances[collabora_code_instance].macros.security_level | default('1') }}</macro_security_level> <enable_websocket_urp desc="Should we enable URP (UNO remote protocol) communication over the websocket. This allows full control of the Kit child server to anyone with access to the websocket including executing macros without confirmation or running arbitrary shell commands in the jail." type="bool" default="false">false</enable_websocket_urp> <enable_metrics_unauthenticated desc="When enabled, the /cool/getMetrics endpoint will not require authentication." type="bool" default="false">false</enable_metrics_unauthenticated> </security> @@ -239,7 +239,7 @@ </locking> <alias_groups desc="default mode is 'first' it allows only the first host when groups are not defined. set mode to 'groups' and define group to allow multiple host and its aliases" mode="groups"> -{% for backend in item.value.backend_storages %} +{% for backend in collabora_code_instances[collabora_code_instance].backend_storages %} <group> <host allow="true">https://{{ backend }}:443</host> </group> @@ -260,8 +260,8 @@ <admin_console desc="Web admin console settings."> <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ item.value.admin.password }}</password> + <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ collabora_code_instances[collabora_code_instance].admin.username }}</username> + <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ collabora_code_instances[collabora_code_instance].admin.password }}</password> <logging desc="Log admin activities irrespective of logging.level"> <admin_login desc="log when an admin logged into the console" type="bool" default="true">true</admin_login> <metrics_fetch desc="log when metrics endpoint is accessed and metrics endpoint authentication is enabled" type="bool" default="true">true</metrics_fetch> diff --git a/roles/apps/collabora/code/instance/templates/config/coolwsd.24.04.6.2.1.xml.j2 b/roles/apps/collabora/code/instance/templates/config/coolwsd.24.04.6.2.1.xml.j2 new file mode 100644 index 00000000..aab67a87 --- /dev/null +++ b/roles/apps/collabora/code/instance/templates/config/coolwsd.24.04.6.2.1.xml.j2 @@ -0,0 +1,340 @@ +<!-- -*- nxml-child-indent: 4; tab-width: 4; indent-tabs-mode: nil -*- --> +<config> + + <!-- For more detailed documentation on typical configuration options please see: + https://sdk.collaboraonline.com/docs/installation/Configuration.html --> + + <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> + <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> + + <accessibility desc="Accessibility settings"> + <enable type="bool" desc="Controls whether accessibility support should be enabled or not." default="false">false</enable> + </accessibility> + + <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> + + <!-- + These are the settings of external (remote) spellchecker and grammar checker services. Currently LanguageTool and Duden Korrekturserver APIs are supported, you can + set either of them. By default they are disabled. To turn the support on, please set "enabled" property to true. It works with self hosted or cloud services, free + and premium as well. The "base_url" may be https://api.languagetoolplus.com/v2 if the cloud version of LanguageTool is used. Please note that your data in the + document e.g. the text part of it will be sent to the cloud API. Please read the respective privacy policies, e.g. https://languagetool.org/legal/privacy. + --> + <languagetool desc="Remote API settings for spell and grammar checking"> + <enabled desc="Enable Remote Spell and Grammar Checker" type="bool" default="false"></enabled> + <base_url desc="HTTP endpoint for the API server, without /check or /languages postfix at the end." type="string" default=""></base_url> + <user_name desc="LanguageTool or Duden account username for premium usage." type="string" default=""></user_name> + <api_key desc="API key provided by LanguageTool or Duden account for premium usage." type="string" default=""></api_key> + <ssl_verification desc="Enable or disable SSL verification. You may have to disable it in test environments with self-signed certificates." type="string" default="true"></ssl_verification> + <rest_protocol desc="REST API protocol. For LanguageTool leave it blank, for Duden Korrekturserver use the string 'duden'." type="string" default=""></rest_protocol> + </languagetool> + + <deepl desc="DeepL API settings for translation service"> + <enabled desc="If true, shows translate option as a menu entry in the compact view and as an icon in the tabbed view." type="bool" default="false">false</enabled> + <api_url desc="URL for the API" type="string" default=""></api_url> + <auth_key desc="Auth Key generated by your account" type="string" default=""></auth_key> + </deepl> + + <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> + <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> + <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> + <mount_namespaces desc="Use mount namespaces instead of coolmount." type="bool" default="true"></mount_namespaces> + + <server_name desc="External hostname:port of the server running coolwsd. If empty, it's derived from the request (please set it if this doesn't work). May be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ collabora_code_instances[collabora_code_instance].publish.hostnames[0] }}</server_name> + <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing cool." type="path" relative="true" default="browser/../"></file_server_root_path> + <hexify_embedded_urls desc="Enable to protect encoded URLs from getting decoded by intermediate hops. Particularly useful on Azure deployments" type="bool" default="false"></hexify_embedded_urls> + <experimental_features desc="Enable/Disable experimental features" type="bool" default="true">true</experimental_features> + + <memproportion desc="The maximum percentage of available memory consumed by all of the Collabora Online Development Edition processes, after which we start cleaning up idle documents. If cgroup memory limits are set, this is the maximum percentage of that limit to consume." type="double" default="80.0"></memproportion> + <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="4">4</num_prespawn_children> + <!-- <fetch_update_check desc="Every number of hours will fetch latest version data. Defaults to 10 hours." type="uint" default="10">10</fetch_update_check> --> + <!-- <allow_update_popup desc="Allows notification about an update in the editor" type="bool" default="true">true</allow_update_popup> --> + <per_document desc="Document-specific settings, including LO Core settings."> + <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> + <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> + <bgsave_priority desc="A (lower) priority for use by background save processes to free time for interactive ones" type="uint" default="5">5</bgsave_priority> + <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> + <pdf_resolution_dpi desc="The resolution, in DPI, used to render PDF documents as image. Memory consumption grows proportionally. Must be a positive value less than 385. Defaults to 96." type="uint" default="96">96</pdf_resolution_dpi> + <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> + <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Disabled when 0. Defaults to 30 seconds." type="uint" default="30">30</idlesave_duration_secs> + <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Disabled when 0. Defaults to 5 minutes." type="uint" default="300">300</autosave_duration_secs> + <background_autosave desc="Allow auto-saves to occur in a forked background process where possible." type="bool" default="true">true</background_autosave> + <background_manualsave desc="Allow manual save to occur in a forked background process where possible" type="bool" default="true">true</background_manualsave> + <always_save_on_exit desc="On exiting the last editor, always perform a save and upload if the document had been modified. This is to allow the storage to store the document, if it had skipped doing so, previously, as an optimization." type="bool" default="false">false</always_save_on_exit> + <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> + <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> + <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> + <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> + <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> + <limit_store_failures desc="Maximum number of consecutive save-and-upload to storage failures when unloading the document. 0 for unlimited (not recommended)." type="uint" default="5">5</limit_store_failures> + <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> + <min_time_between_saves_ms desc="Minimum number of milliseconds between saving the document on disk." type="uint" default="500">500</min_time_between_saves_ms> + <min_time_between_uploads_ms desc="Minimum number of milliseconds between uploading the document to storage." type="uint" default="5000">5000</min_time_between_uploads_ms> + <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="true"> + <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> + <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> + <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> + <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> + <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> + <lost_kit_grace_period_secs desc="The minimum grace period for a lost kit process (not referenced by coolwsd) to resolve its lost status before it is terminated. To disable the cleanup of lost kits use value 0" default="120">120</lost_kit_grace_period_secs> + </cleanup> + </per_document> + + <per_view desc="View-specific settings."> + <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 300 seconds." type="uint" default="300">300</out_of_focus_timeout_secs> + <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> + <custom_os_info desc="Custom string shown as OS version in About dialog, get from system if empty." type="string" default=""></custom_os_info> + </per_view> + + <ver_suffix desc="Appended to etags to allow easy refresh of changed files during development" type="string" default=""></ver_suffix> + + <logging> + <color type="bool">true</color> + <!-- + Note to developers: When you do "make run", the logging.level will be set on the + coolwsd command line, so if you want to change it for your testing, do it in + Makefile.am, not here. + --> + <level type="string" desc="Can be 0-8 (with the lowest numbers being the least verbose), or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> + <level_startup type="string" desc="As for level - but for the initial startup phase which is most problematic, logging reverts to level configured above when startup is complete" default="trace">trace</level_startup> + <disabled_areas type="string" desc="High verbosity logging ie. info to trace are disable-able, comma separated: Generic, Pixel, Socket, WebSocket, Http, WebServer, Storage, WOPI, Admin, Javascript" default="Socket,WebSocket,Admin">Socket,WebSocket,Admin,Pixel</disabled_areas> + <most_verbose_level_settable_from_client type="string" desc="A loggingleveloverride message from the client can not set a more verbose log level than this" default="notice">notice</most_verbose_level_settable_from_client> + <least_verbose_level_settable_from_client type="string" desc="A loggingleveloverride message from a client can not set a less verbose log level than this" default="fatal">fatal</least_verbose_level_settable_from_client> + <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> + <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" + See also: https://docs.libreoffice.org/sal/html/sal_log.html --> + <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> + <file enable="false"> + <!-- If you use other path than /var/log and you run coolwsd from systemd, make sure that you enable that path in coolwsd.service (ReadWritePaths). --> + <property name="path" desc="Log file path.">/var/log/coolwsd.log</property> + <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> + <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> + <property name="compress" desc="Enable/disable log file compression.">true</property> + <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> + <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> + <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> + <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> + </file> + <anonymize> + <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> + <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> + </anonymize> + <docstats type="bool" desc="Enable to see document handling information in logs." default="false">false</docstats> + <userstats desc="Enable user stats. i.e: logs the details of a file and user" type="bool" default="false">false</userstats> + <disable_server_audit type="bool" desc="Disabled server audit dialog and notification. Admin will no longer see warnings in the application user interface. This doesn't affect log file." default="false">false</disable_server_audit> + </logging> + + <!-- + Note to developers: When you do "make run", the trace_event[@enable] will be set on the + coolwsd command line, so if you want to change it for your testing, do it in Makefile.am, + not here. + --> + <trace_event desc="The possibility to turn on generation of a Chrome Trace Event file" enable="false"> + <path desc="Output path for the Trace Event file, to which they will be written if turned on at run-time" type="string" default="/var/log/coolwsd.trace.json">/var/log/coolwsd.trace.json</path> + </trace_event> + + <browser_logging desc="Logging in the browser console" default="false">false</browser_logging> + + <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> + <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/cooltrace-%.gz" compress="true" snapshot="false"></path> + <filter> + <message desc="Regex pattern of messages to exclude"></message> + </filter> + <outgoing> + <record desc="Whether or not to record outgoing messages" default="false">false</record> + </outgoing> + </trace> + + <net desc="Network settings"> + <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, coolwsd unexpectedly listens on [::1] only. + You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> + <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> + <listen type="string" default="any" desc="Listen address that coolwsd binds to. Can be 'any' or 'loopback'.">any</listen> + <!-- this allows you to shift all of our URLs into a sub-path from + https://my.com/browser/a123... to https://my.com/my/sub/path/browser/a123... --> + <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> + <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> + <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> + <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> + <host desc="The IPv6 loopback (localhost) address.">::1</host> + <host desc="The IPv4 private 172.16.0.0/12 subnet part 1.">172\.1[6789]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.1[6789]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 private 172.16.0.0/12 subnet part 2.">172\.2[0-9]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.2[0-9]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 private 172.16.0.0/12 subnet part 3.">172\.3[01]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.3[01]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 private 10.0.0.0/8 subnet (Podman).">10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}</host> + </post_allow> + <lok_allow desc="Allowed hosts as an external data source inside edited files. All allowed post_allow.host and storage.wopi entries are also considered to be allowed as a data source. Used for example in: PostMessage Action_InsertGraphics, =WEBSERVICE() function, external reference in the cell."> + <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> + <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> + <host desc="The IPv6 loopback (localhost) address.">::1</host> + <host desc="The IPv4 private 172.16.0.0/12 subnet part 1.">172\.1[6789]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.1[6789]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 private 172.16.0.0/12 subnet part 2.">172\.2[0-9]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.2[0-9]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 private 172.16.0.0/12 subnet part 3.">172\.3[01]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.3[01]\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="The IPv4 private 10.0.0.0/8 subnet (Podman).">10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}</host> + <host desc="Localhost access by name">localhost</host> + </lok_allow> + <content_security_policy desc="Customize the CSP header by specifying one or more policy-directive, separated by semicolons. See w3.org/TR/CSP2"></content_security_policy> + <frame_ancestors desc="OBSOLETE: Use content_security_policy. Specify who is allowed to embed the Collabora Online iframe (coolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> + <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by coolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> + + <!-- this setting radically changes how online works, it should not be used in a production environment --> + <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> + </net> + + <ssl desc="SSL settings"> + <!-- switches from https:// + wss:// to http:// + ws:// --> + <enable type="bool" desc="Controls whether SSL encryption between coolwsd and the network is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> + <!-- SSL off-load can be done in a proxy, if so disable SSL, and enable termination below in production --> + <termination desc="Connection via proxy where coolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> + <cert_file_path desc="Path to the cert file" relative="false">/etc/coolwsd/cert.pem</cert_file_path> + <key_file_path desc="Path to the key file" relative="false">/etc/coolwsd/key.pem</key_file_path> + <ca_file_path desc="Path to the ca file" relative="false">/etc/coolwsd/ca-chain.cert.pem</ca_file_path> + <ssl_verification desc="Enable or disable SSL verification of hosts remote to coolwsd. If true SSL verification will be strict, otherwise certs of hosts will not be verified. You may have to disable it in test environments with self-signed certificates." type="string" default="false">false</ssl_verification> + <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> + <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> + <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> + <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> + <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> + <pin></pin> + </pins> + </hpkp> + <sts desc="Strict-Transport-Security settings, per rfc6797. Subdomains are always included."> + <enabled desc="Whether or not Strict-Transport-Security is enabled. Enable only when ready for production. Cannot be disabled without resetting the browsers." type="bool" default="false">false</enabled> + <max_age desc="Strict-Transport-Security max-age directive, in seconds. 0 is allowed; please see rfc6797 for details. Defaults to 1 year." type="int" default="31536000">31536000</max_age> + </sts> + </ssl> + + <security desc="Altering these defaults potentially opens you to significant risk"> + <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> + + <!-- deprecated: If capabilities is 'false', coolwsd will assume mount_namespaces of 'true' to achieve + this goal, only avoiding chroot for process isolation if linux namespaces are unavailable --> + <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> + + <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> + <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic and Python scripts to execute both installed and from documents. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ collabora_code_instances[collabora_code_instance].macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> + <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ collabora_code_instances[collabora_code_instance].macros.security_level | default('1') }}</macro_security_level> + <enable_websocket_urp desc="Should we enable URP (UNO remote protocol) communication over the websocket. This allows full control of the Kit child server to anyone with access to the websocket including executing macros without confirmation or running arbitrary shell commands in the jail." type="bool" default="false">false</enable_websocket_urp> + <enable_metrics_unauthenticated desc="When enabled, the /cool/getMetrics endpoint will not require authentication." type="bool" default="false">false</enable_metrics_unauthenticated> + </security> + + <certificates> + <database_path type="string" desc="Path to the NSS certificates that are used for signing documents" default=""></database_path> + </certificates> + + <watermark> + <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> + <text desc="Watermark text to be displayed on the document if entered" type="string"></text> + </watermark> + + + <user_interface> + <mode type="string" desc="Controls the user interface style. The 'default' means: Take the value from ui_defaults, or decide for one of compact or tabbed (default|compact|tabbed)" default="default">default</mode> + <use_integration_theme desc="Use theme from the integrator" type="bool" default="true">true</use_integration_theme> + </user_interface> + + <storage desc="Backend storage"> + <filesystem allow="false" /> + <wopi desc="Allow/deny wopi storage." allow="true"> + <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> + <locking desc="Locking settings"> + <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> + </locking> + + <alias_groups desc="default mode is 'first' it allows only the first host when groups are not defined. set mode to 'groups' and define group to allow multiple host and its aliases" mode="groups"> +{% for backend in collabora_code_instances[collabora_code_instance].backend_storages %} + <group> + <host allow="true">https://{{ backend }}:443</host> + </group> +{% endfor %} + </alias_groups> + + <is_legacy_server desc="Set to true for legacy server that need deprecated headers." type="bool" default="false"></is_legacy_server> + </wopi> + <ssl desc="SSL settings"> + <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> + <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and coolwsd. When empty this defaults to following the ssl.enable setting"></enable> + <cert_file_path desc="Path to the cert file. When empty this defaults to following the ssl.cert_file_path setting" relative="false"></cert_file_path> + <key_file_path desc="Path to the key file. When empty this defaults to following the ssl.key_file_path settinge" relative="false"></key_file_path> + <ca_file_path desc="Path to the ca file. When empty this defaults to following the ssl.ca_file_path setting" relative="false"></ca_file_path> + <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overridden only if absolutely needed."></cipher_list> + </ssl> + </storage> + + <admin_console desc="Web admin console settings."> + <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> + <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> + <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ collabora_code_instances[collabora_code_instance].admin.username }}</username> + <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or coolconfig to set up a secure password.">{{ collabora_code_instances[collabora_code_instance].admin.password }}</password> + <logging desc="Log admin activities irrespective of logging.level"> + <admin_login desc="log when an admin logged into the console" type="bool" default="true">true</admin_login> + <metrics_fetch desc="log when metrics endpoint is accessed and metrics endpoint authentication is enabled" type="bool" default="true">true</metrics_fetch> + <monitor_connect desc="log when external monitor gets connected" type="bool" default="true">true</monitor_connect> + <admin_action desc="log when admin does some action for example killing a process" type="bool" default="true">true</admin_action> + </logging> + </admin_console> + + <monitors desc="Addresses of servers we connect to on start for monitoring"> + <!-- <monitor desc="Address of the monitor and interval after which it should try reconnting after disconnect" retryInterval="20">wss://foobar:234/ws</monitor> --> + </monitors> + + <quarantine_files desc="Files are stored here to be examined later in cases of crashes or similar situation." default="false" enable="false"> + <limit_dir_size_mb desc="Maximum directory size, in MBs. On exceeding the specified limit, older files will be deleted." default="250" type="uint"></limit_dir_size_mb> + <max_versions_to_maintain desc="How many versions of the same file to keep." default="5" type="uint"></max_versions_to_maintain> + <path desc="Absolute path of the directory under which quarantined files will be stored. Do not use a relative path." type="path" relative="false"></path> + <expiry_min desc="Time in mins after quarantined files will be deleted." type="int" default="3000"></expiry_min> + </quarantine_files> + + <remote_config> + <remote_url desc="remote server to which you will send request to get remote config in response" type="string" default=""></remote_url> + </remote_config> + + <stop_on_config_change desc="Stop coolwsd whenever config files change." type="bool" default="false">false</stop_on_config_change> + + <remote_font_config> + <url desc="URL of optional JSON file that lists fonts to be included in Online" type="string" default=""></url> + </remote_font_config> + + <home_mode> + <enable desc="Enable more configuration options for home users" type="bool" default="false">false</enable> + </home_mode> + + <fonts_missing> + <handling desc="How to handle fonts mising in a document: 'report', 'log', 'both', or 'ignore'" type="string" default="log">log</handling> + </fonts_missing> + + <indirection_endpoint> + <url desc="URL endpoint to server which servers routeToken in json format" default=""></url> + <migration_timeout_secs desc="The maximum number of seconds waiting for shutdown migration message from indirection server before unloading an document. Defaults to 180 second." type="uint" default="180"></migration_timeout_secs> + </indirection_endpoint> + + + + + + <zotero desc="Zotero plugin configuration. For more details about Zotero visit https://www.zotero.org/"> + <enable desc="Enable Zotero plugin." type="bool" default="true">true</enable> + </zotero> + + <help_url desc="The Help root URL, or empty for no help (hides the Help buttons)" type="string" default="https://help.collaboraoffice.com/help.html?">https://help.collaboraoffice.com/help.html?</help_url> + + <overwrite_mode> + <enable desc="Enable overwrite mode (user can use insert key)" type="bool" default="true">true</enable> + </overwrite_mode> + + <wasm desc="WASM-specific settings"> + <enable desc="Enable WASM support" type="bool" default="false"></enable> + <force desc="When enabled, all requests are redirected to WASM." type="bool" default="false"></force> + </wasm> + +</config> diff --git a/roles/apps/collabora/code/instance/templates/nginx-vhost.conf.j2 b/roles/apps/collabora/code/instance/templates/nginx-vhost.conf.j2 new file mode 100644 index 00000000..a7248194 --- /dev/null +++ b/roles/apps/collabora/code/instance/templates/nginx-vhost.conf.j2 @@ -0,0 +1,113 @@ +client_max_body_size 128M; + +# static files +location ^~ /browser { + include snippets/proxy-nobuff.conf; + include snippets/proxy-forward-headers.conf; + + proxy_set_header Host $http_host; +{% if collabora_code_instances[collabora_code_instance].publish.zone.publisher == inventory_hostname %} + proxy_pass https://127.0.0.1:{{ collabora_code_instances[collabora_code_instance].port }}; +{% else %} + proxy_pass https://{{ ansible_default_ipv4.address }}:{{ collabora_code_instances[collabora_code_instance].port }}; +{% endif %} + proxy_ssl_trusted_certificate /etc/ssl/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}-ca-crt.pem; + proxy_ssl_verify on; + proxy_ssl_name collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}; + proxy_ssl_protocols TLSv1.3; +} + +# WOPI discovery URL +location ^~ /hosting/discovery { + include snippets/proxy-nobuff.conf; + include snippets/proxy-forward-headers.conf; + + proxy_set_header Host $http_host; +{% if collabora_code_instances[collabora_code_instance].publish.zone.publisher == inventory_hostname %} + proxy_pass https://127.0.0.1:{{ collabora_code_instances[collabora_code_instance].port }}; +{% else %} + proxy_pass https://{{ ansible_default_ipv4.address }}:{{ collabora_code_instances[collabora_code_instance].port }}; +{% endif %} + proxy_ssl_trusted_certificate /etc/ssl/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}-ca-crt.pem; + proxy_ssl_verify on; + proxy_ssl_name collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}; + proxy_ssl_protocols TLSv1.3; +} + +# Capabilities +location ^~ /hosting/capabilities { + include snippets/proxy-nobuff.conf; + include snippets/proxy-forward-headers.conf; + + proxy_set_header Host $http_host; +{% if collabora_code_instances[collabora_code_instance].publish.zone.publisher == inventory_hostname %} + proxy_pass https://127.0.0.1:{{ collabora_code_instances[collabora_code_instance].port }}; +{% else %} + proxy_pass https://{{ ansible_default_ipv4.address }}:{{ collabora_code_instances[collabora_code_instance].port }}; +{% endif %} + proxy_ssl_trusted_certificate /etc/ssl/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}-ca-crt.pem; + proxy_ssl_verify on; + proxy_ssl_name collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}; + proxy_ssl_protocols TLSv1.3; +} + +# main websocket +location ~ ^/cool/(.*)/ws$ { + include snippets/proxy-nobuff.conf; + include snippets/proxy-forward-headers.conf; + + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection $connection_upgrade; + + proxy_read_timeout 36000s; + + proxy_set_header Host $http_host; +{% if collabora_code_instances[collabora_code_instance].publish.zone.publisher == inventory_hostname %} + proxy_pass https://127.0.0.1:{{ collabora_code_instances[collabora_code_instance].port }}; +{% else %} + proxy_pass https://{{ ansible_default_ipv4.address }}:{{ collabora_code_instances[collabora_code_instance].port }}; +{% endif %} + proxy_ssl_trusted_certificate /etc/ssl/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}-ca-crt.pem; + proxy_ssl_verify on; + proxy_ssl_name collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}; + proxy_ssl_protocols TLSv1.3; +} + +# download, presentation and image upload +location ~ ^/(c|l)ool { + include snippets/proxy-nobuff.conf; + include snippets/proxy-forward-headers.conf; + + proxy_set_header Host $http_host; +{% if collabora_code_instances[collabora_code_instance].publish.zone.publisher == inventory_hostname %} + proxy_pass https://127.0.0.1:{{ collabora_code_instances[collabora_code_instance].port }}; +{% else %} + proxy_pass https://{{ ansible_default_ipv4.address }}:{{ collabora_code_instances[collabora_code_instance].port }}; +{% endif %} + proxy_ssl_trusted_certificate /etc/ssl/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}-ca-crt.pem; + proxy_ssl_verify on; + proxy_ssl_name collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}; + proxy_ssl_protocols TLSv1.3; +} + +# Admin Console websocket +location ^~ /cool/adminws { + include snippets/proxy-nobuff.conf; + include snippets/proxy-forward-headers.conf; + + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection $connection_upgrade; + + proxy_read_timeout 36000s; + + proxy_set_header Host $http_host; +{% if collabora_code_instances[collabora_code_instance].publish.zone.publisher == inventory_hostname %} + proxy_pass https://127.0.0.1:{{ collabora_code_instances[collabora_code_instance].port }}; +{% else %} + proxy_pass https://{{ ansible_default_ipv4.address }}:{{ collabora_code_instances[collabora_code_instance].port }}; +{% endif %} + proxy_ssl_trusted_certificate /etc/ssl/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}/apps-publish-{{ collabora_code_instances[collabora_code_instance].publish.zone.name }}-ca-crt.pem; + proxy_ssl_verify on; + proxy_ssl_name collabora-code-{{ collabora_code_instance }}.{{ inventory_hostname }}; + proxy_ssl_protocols TLSv1.3; +} diff --git a/roles/apps/collabora/code/instance/templates/pod-spec.yml.j2 b/roles/apps/collabora/code/instance/templates/pod-spec.yml.j2 new file mode 100644 index 00000000..a01bafee --- /dev/null +++ b/roles/apps/collabora/code/instance/templates/pod-spec.yml.j2 @@ -0,0 +1,40 @@ +containers: +- name: collabora-code + image: "collabora/code{% if 'custom_image' in collabora_code_instances[collabora_code_instance] %}/{{ collabora_code_instance }}{% endif %}:{{ collabora_code_instances[collabora_code_instance].version }}" + resources: + limits: + memory: "4Gi" + env: + - name: "DONT_GEN_SSL_CERT" + value: "1" + volumeMounts: + - name: temp + mountPath: /opt/cool/child-roots + - name: config + mountPath: /etc/coolwsd/coolwsd.xml + subPath: coolwsd.xml + readOnly: true + - name: config + mountPath: /etc/coolwsd/ca-chain.cert.pem + subPath: cert.pem + readOnly: true + - name: config + mountPath: /etc/coolwsd/cert.pem + subPath: cert.pem + readOnly: true + - name: config + mountPath: /etc/coolwsd/key.pem + subPath: key.pem + readOnly: true + ports: + - containerPort: 9980 + hostPort: {{ collabora_code_instances[collabora_code_instance].port }} + hostIP: 127.0.0.1 +volumes: +- name: config + hostPath: + path: "{{ collabora_code_instance_basepath }}/config/" + type: Directory +- name: temp + emptyDir: + medium: Memory diff --git a/roles/apps/collabora/code/tasks/custom-image.yml b/roles/apps/collabora/code/tasks/custom-image.yml deleted file mode 100644 index 84f6b1ae..00000000 --- a/roles/apps/collabora/code/tasks/custom-image.yml +++ /dev/null @@ -1,24 +0,0 @@ ---- -- name: create build directory for custom image - file: - path: "{{ collabora_code_base_path }}/{{ item.key }}/build" - state: directory - -- name: generate Dockerfile for custom image - copy: - content: | - FROM {{ item.value.custom_image.from | default('collabora/code:' + item.value.version) }} - {{ item.value.custom_image.dockerfile }} - dest: "{{ collabora_code_base_path }}/{{ item.key }}/build/Dockerfile" - register: collabora_code_custom_image_docker - -- name: build custom image - docker_image: - name: "collabora/code/{{ item.key }}:{{ item.value.version }}" - state: present - force_source: "{{ collabora_code_custom_image_docker is changed }}" - source: build - build: - path: "{{ collabora_code_base_path }}/{{ item.key }}/build" - network: host - pull: yes diff --git a/roles/apps/collabora/code/tasks/main.yml b/roles/apps/collabora/code/tasks/main.yml index 84efec5c..11b3fee4 100644 --- a/roles/apps/collabora/code/tasks/main.yml +++ b/roles/apps/collabora/code/tasks/main.yml @@ -1,52 +1,7 @@ --- -- name: create collabora-code config subdirectory +- name: instance specific tasks loop: "{{ collabora_code_instances | list }}" - file: - path: "{{ collabora_code_base_path }}/{{ item }}/config" - state: directory - mode: 0750 - -- name: generate configuration file - loop: "{{ collabora_code_instances | dict2items }}" loop_control: - label: "{{ item.key }}" - template: - src: "config/{{ item.value.version | collabora_code_loolvcool | ternary('lool', 'cool') }}wsd.{{ item.value.version }}.xml.j2" - dest: "{{ collabora_code_base_path }}/{{ item.key }}/config/{{ item.value.version | collabora_code_loolvcool | ternary('lool', 'cool') }}wsd.xml" - -- name: remove legacy configuration file - loop: "{{ collabora_code_instances | dict2items }}" - loop_control: - label: "{{ item.key }}" - file: - path: "{{ collabora_code_base_path }}/{{ item.key }}/config/{{ item.value.version | collabora_code_loolvcool | ternary('cool', 'lool') }}wsd.xml" - state: absent - -- name: build custom image - loop: "{{ collabora_code_instances | dict2items }}" - loop_control: - label: "{{ item.key }}" - when: "'custom_image' in item.value" - include_tasks: custom-image.yml - -- name: install pod manifest - loop: "{{ collabora_code_instances | dict2items }}" - loop_control: - label: "{{ item.key }}" - vars: - kubernetes_standalone_pod: - name: "collabora-code-{{ item.key }}" - spec: "{{ lookup('template', 'pod-spec.yml.j2') }}" - mode: "0600" - config_hash_items: - - path: "{{ collabora_code_base_path }}/{{ item.key }}/config/{{ item.value.version | collabora_code_loolvcool | ternary('lool', 'cool') }}wsd.xml" - properties: - - checksum + loop_var: collabora_code_instance include_role: - name: kubernetes/standalone/pod - -- name: install nginx vhost config - loop: "{{ collabora_code_instances | dict2items }}" - loop_control: - label: "{{ item.key }}" - include_tasks: nginx-vhost.yml + name: apps/collabora/code/instance diff --git a/roles/apps/collabora/code/tasks/nginx-vhost.yml b/roles/apps/collabora/code/tasks/nginx-vhost.yml deleted file mode 100644 index afd8f1e0..00000000 --- a/roles/apps/collabora/code/tasks/nginx-vhost.yml +++ /dev/null @@ -1,17 +0,0 @@ ---- -- name: render nginx-vhost custom config - set_fact: - collabora_code_nginx_vhost_custom: "{{ lookup('template', 'nginx-vhost.conf.j2') }}" - -- name: configure nginx vhost - vars: - nginx_vhost: - name: "collabora-code-{{ item.key }}" - template: generic - tls: - certificate_provider: "{{ acme_client }}" - hostnames: - - "{{ item.value.hostname }}" - custom: "{{ collabora_code_nginx_vhost_custom }}" - include_role: - name: nginx/vhost diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.0.14.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.0.14.xml.j2 deleted file mode 100644 index cbdae29a..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.0.14.xml.j2 +++ /dev/null @@ -1,179 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.10.2.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.10.2.xml.j2 deleted file mode 100644 index 7f6c7c0f..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.10.2.xml.j2 +++ /dev/null @@ -1,192 +0,0 @@ -<!-- -*- nxml-child-indent: 4; tab-width: 4; indent-tabs-mode: nil -*- --> - -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <pdf_resolution_dpi desc="The resolution, in DPI, used to render PDF documents as image. Memory consumption grows proportionally. Must be a positive value less than 385. Defaults to 96." type="uint" default="96">96</pdf_resolution_dpi> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - <lost_kit_grace_period_secs desc="The minimum grace period for a lost kit process (not referenced by loolwsd) to resolve its lost status before it is terminated. To disable the cleanup of lost kits use value 0" default="120">120</lost_kit_grace_period_secs> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8 (with the lowest numbers being the least verbose), or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <most_verbose_level_settable_from_client type="string" desc="A loggingleveloverride message from the client can not set a more verbose log level than this" default="notice">notice</most_verbose_level_settable_from_client> - <least_verbose_level_settable_from_client type="string" desc="A loggingleveloverride message from a client can not set a less verbose log level than this" default="fatal">fatal</least_verbose_level_settable_from_client> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <trace_event desc="The possibility to turn on generation of a Chrome Trace Event file" enable="false"> - <path desc="Output path for the Trace Event file, to which they will be written if turned on at run-time" type="string" default="/var/log/loolwsd.trace.json">/var/log/loolwsd.trace.json</path> - </trace_event> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - - - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.14.3.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.14.3.xml.j2 deleted file mode 100644 index e9ababf2..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.14.3.xml.j2 +++ /dev/null @@ -1,203 +0,0 @@ -<!-- -*- nxml-child-indent: 4; tab-width: 4; indent-tabs-mode: nil -*- --> -<config> - - <!-- For more detailed documentation on typical configuration options please see: - https://sdk.collaboraonline.com/docs/installation/Configuration.html --> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - <hexify_embedded_urls desc="Enable to protect encoded URLs from getting decoded by intermediate hops. Particularly useful on Azure deployments" type="bool" default="false"></hexify_embedded_urls> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <pdf_resolution_dpi desc="The resolution, in DPI, used to render PDF documents as image. Memory consumption grows proportionally. Must be a positive value less than 385. Defaults to 96." type="uint" default="96">96</pdf_resolution_dpi> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - <lost_kit_grace_period_secs desc="The minimum grace period for a lost kit process (not referenced by loolwsd) to resolve its lost status before it is terminated. To disable the cleanup of lost kits use value 0" default="120">120</lost_kit_grace_period_secs> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - <ver_suffix desc="Appended to etags to allow easy refresh of changed files during development" type="string" default=""></ver_suffix> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8 (with the lowest numbers being the least verbose), or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <most_verbose_level_settable_from_client type="string" desc="A loggingleveloverride message from the client can not set a more verbose log level than this" default="notice">notice</most_verbose_level_settable_from_client> - <least_verbose_level_settable_from_client type="string" desc="A loggingleveloverride message from a client can not set a less verbose log level than this" default="fatal">fatal</least_verbose_level_settable_from_client> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <trace_event desc="The possibility to turn on generation of a Chrome Trace Event file" enable="false"> - <path desc="Output path for the Trace Event file, to which they will be written if turned on at run-time" type="string" default="/var/log/loolwsd.trace.json">/var/log/loolwsd.trace.json</path> - </trace_event> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <!-- this allows you to shift all of our URLs into a sub-path from - https://my.com/loleaflet/a123... to https://my.com/my/sub/path/loleaflet/a123... --> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - - <!-- this setting radically changes how online works, it should not be used in a production environment --> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - </net> - - <ssl desc="SSL settings"> - <!-- switches from https:// + wss:// to http:// + ws:// --> - <enable type="bool" desc="Controls whether SSL encryption between loolwsd and the network is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <!-- SSL off-load can be done in a proxy, if so disable SSL, and enable termination below in production --> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> - <enable_metrics_unauthenticated desc="When enabled, the /lool/getMetrics endpoint will not require authentication." type="bool" default="false">false</enable_metrics_unauthenticated> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - - - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.3.3.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.3.3.xml.j2 deleted file mode 100644 index 2542d252..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.3.3.xml.j2 +++ /dev/null @@ -1,180 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.4.3.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.4.3.xml.j2 deleted file mode 100644 index 2542d252..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.4.3.xml.j2 +++ /dev/null @@ -1,180 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.6.2.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.6.2.xml.j2 deleted file mode 100644 index 2542d252..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.6.2.xml.j2 +++ /dev/null @@ -1,180 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.7.3.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.7.3.xml.j2 deleted file mode 100644 index bd6eab16..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.7.3.xml.j2 +++ /dev/null @@ -1,184 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.7.5.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.7.5.xml.j2 deleted file mode 100644 index d3d5686f..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.7.5.xml.j2 +++ /dev/null @@ -1,184 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <pdf_resolution_dpi desc="The resolution, in DPI, used to render PDF documents as image. Memory consumption grows proportionally. Must be a positive value less than 385. Defaults to 96." type="uint" default="96">96</pdf_resolution_dpi> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/config/loolwsd.6.4.8.1.xml.j2 b/roles/apps/collabora/code/templates/config/loolwsd.6.4.8.1.xml.j2 deleted file mode 100644 index 4daa414c..00000000 --- a/roles/apps/collabora/code/templates/config/loolwsd.6.4.8.1.xml.j2 +++ /dev/null @@ -1,188 +0,0 @@ -<config> - - <!-- Note: 'default' attributes are used to document a setting's default value as well as to use as fallback. --> - <!-- Note: When adding a new entry, a default must be set in WSD in case the entry is missing upon deployment. --> - - <allowed_languages desc="List of supported languages of Writing Aids (spell checker, grammar checker, thesaurus, hyphenation) on this instance. Allowing too many has negative effect on startup performance." default="de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru">de_DE en_GB en_US es_ES fr_FR it nl pt_BR pt_PT ru</allowed_languages> - - <sys_template_path desc="Path to a template tree with shared libraries etc to be used as source for chroot jails for child processes." type="path" relative="true" default="systemplate"></sys_template_path> - <child_root_path desc="Path to the directory under which the chroot jails for the child processes will be created. Should be on the same file system as systemplate and lotemplate. Must be an empty directory." type="path" relative="true" default="jails"></child_root_path> - <mount_jail_tree desc="Controls whether the systemplate and lotemplate contents are mounted or not, which is much faster than the default of linking/copying each file." type="bool" default="true"></mount_jail_tree> - - <server_name desc="External hostname:port of the server running loolwsd. If empty, it's derived from the request (please set it if this doesn't work). Must be specified when behind a reverse-proxy or when the hostname is not reachable directly." type="string" default="">{{ item.value.hostname }}</server_name> - <file_server_root_path desc="Path to the directory that should be considered root for the file server. This should be the directory containing loleaflet." type="path" relative="true" default="loleaflet/../"></file_server_root_path> - - <memproportion desc="The maximum percentage of system memory consumed by all of the Collabora Online Development Edition, after which we start cleaning up idle documents" type="double" default="80.0"></memproportion> - <num_prespawn_children desc="Number of child processes to keep started in advance and waiting for new clients." type="uint" default="1">1</num_prespawn_children> - <per_document desc="Document-specific settings, including LO Core settings."> - <max_concurrency desc="The maximum number of threads to use while processing a document." type="uint" default="4">4</max_concurrency> - <batch_priority desc="A (lower) priority for use by batch eg. convert-to processes to avoid starving interactive ones" type="uint" default="5">5</batch_priority> - <document_signing_url desc="The endpoint URL of signing server, if empty the document signing is disabled" type="string" default=""></document_signing_url> - <redlining_as_comments desc="If true show red-lines as comments" type="bool" default="false">false</redlining_as_comments> - <pdf_resolution_dpi desc="The resolution, in DPI, used to render PDF documents as image. Memory consumption grows proportionally. Must be a positive value less than 385. Defaults to 96." type="uint" default="96">96</pdf_resolution_dpi> - <idle_timeout_secs desc="The maximum number of seconds before unloading an idle document. Defaults to 1 hour." type="uint" default="3600">3600</idle_timeout_secs> - <!-- Idle save and auto save are checked every 30 seconds --> - <!-- They are disabled when the value is zero or negative. --> - <idlesave_duration_secs desc="The number of idle seconds after which document, if modified, should be saved. Defaults to 30 seconds." type="int" default="30">30</idlesave_duration_secs> - <autosave_duration_secs desc="The number of seconds after which document, if modified, should be saved. Defaults to 5 minutes." type="int" default="300">300</autosave_duration_secs> - <always_save_on_exit desc="On exiting the last editor, always perform the save, even if the document is not modified." type="bool" default="false">false</always_save_on_exit> - <limit_virt_mem_mb desc="The maximum virtual memory allowed to each document process. 0 for unlimited." type="uint">0</limit_virt_mem_mb> - <limit_stack_mem_kb desc="The maximum stack size allowed to each document process. 0 for unlimited." type="uint">8000</limit_stack_mem_kb> - <limit_file_size_mb desc="The maximum file size allowed to each document process to write. 0 for unlimited." type="uint">0</limit_file_size_mb> - <limit_num_open_files desc="The maximum number of files allowed to each document process to open. 0 for unlimited." type="uint">0</limit_num_open_files> - <limit_load_secs desc="Maximum number of seconds to wait for a document load to succeed. 0 for unlimited." type="uint" default="100">100</limit_load_secs> - <limit_convert_secs desc="Maximum number of seconds to wait for a document conversion to succeed. 0 for unlimited." type="uint" default="100">100</limit_convert_secs> - <cleanup desc="Checks for resource consuming (bad) documents and kills associated kit process. A document is considered resource consuming (bad) if is in idle state for idle_time_secs period and memory usage passed limit_dirty_mem_mb or CPU usage passed limit_cpu_per" enable="false"> - <cleanup_interval_ms desc="Interval between two checks" type="uint" default="10000">10000</cleanup_interval_ms> - <bad_behavior_period_secs desc="Minimum time period for a document to be in bad state before associated kit process is killed. If in this period the condition for bad document is not met once then this period is reset" type="uint" default="60">60</bad_behavior_period_secs> - <idle_time_secs desc="Minimum idle time for a document to be candidate for bad state" type="uint" default="300">300</idle_time_secs> - <limit_dirty_mem_mb desc="Minimum memory usage for a document to be candidate for bad state" type="uint" default="3072">3072</limit_dirty_mem_mb> - <limit_cpu_per desc="Minimum CPU usage for a document to be candidate for bad state" type="uint" default="85">85</limit_cpu_per> - </cleanup> - </per_document> - - <per_view desc="View-specific settings."> - <out_of_focus_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the browser tab is no longer in focus. Defaults to 120 seconds." type="uint" default="120">120</out_of_focus_timeout_secs> - <idle_timeout_secs desc="The maximum number of seconds before dimming and stopping updates when the user is no longer active (even if the browser is in focus). Defaults to 15 minutes." type="uint" default="900">900</idle_timeout_secs> - </per_view> - - <loleaflet_html desc="Allows UI customization by replacing the single endpoint of loleaflet.html" type="string" default="loleaflet.html">loleaflet.html</loleaflet_html> - - <logging> - <color type="bool">true</color> - <level type="string" desc="Can be 0-8, or none (turns off logging), fatal, critical, error, warning, notice, information, debug, trace" default="warning">warning</level> - <protocol type="bool" desc="Enable minimal client-site JS protocol logging from the start">false</protocol> - <!-- lokit_sal_log example: Log WebDAV-related messages, that is interesting for debugging Insert - Image operation: "+TIMESTAMP+INFO.ucb.ucp.webdav+WARN.ucb.ucp.webdav" - See also: https://docs.libreoffice.org/sal/html/sal_log.html --> - <lokit_sal_log type="string" desc="Fine tune log messages from LOKit. Default is to suppress log messages from LOKit." default="-INFO-WARN">-INFO-WARN</lokit_sal_log> - <file enable="false"> - <!-- If you use other path than /var/log and you run loolwsd from systemd, make sure that you enable that path in loolwsd.service (ReadWritePaths). --> - <property name="path" desc="Log file path.">/var/log/loolwsd.log</property> - <property name="rotation" desc="Log file rotation strategy. See Poco FileChannel.">never</property> - <property name="archive" desc="Append either timestamp or number to the archived log filename.">timestamp</property> - <property name="compress" desc="Enable/disable log file compression.">true</property> - <property name="purgeAge" desc="The maximum age of log files to preserve. See Poco FileChannel.">10 days</property> - <property name="purgeCount" desc="The maximum number of log archives to preserve. Use 'none' to disable purging. See Poco FileChannel.">10</property> - <property name="rotateOnOpen" desc="Enable/disable log file rotation on opening.">true</property> - <property name="flush" desc="Enable/disable flushing after logging each line. May harm performance. Note that without flushing after each line, the log lines from the different processes will not appear in chronological order.">false</property> - </file> - <anonymize> - <anonymize_user_data type="bool" desc="Enable to anonymize/obfuscate of user-data in logs. If default is true, it was forced at compile-time and cannot be disabled." default="false">false</anonymize_user_data> - <anonymization_salt type="uint" desc="The salt used to anonymize/obfuscate user-data in logs. Use a secret 64-bit random number." default="82589933">82589933</anonymization_salt> - </anonymize> - </logging> - - <event_trace> - <path type="string" desc="Event Trace file path." default="/var/log/loolwsd.trace">/var/log/loolwsd.trace</path> - </event_trace> - - <loleaflet_logging desc="Logging in the browser console" default="false">false</loleaflet_logging> - - <trace desc="Dump commands and notifications for replay. When 'snapshot' is true, the source file is copied to the path first." enable="false"> - <path desc="Output path to hold trace file and docs. Use '%' for timestamp to avoid overwriting. For example: /some/path/to/looltrace-%.gz" compress="true" snapshot="false"></path> - <filter> - <message desc="Regex pattern of messages to exclude"></message> - </filter> - <outgoing> - <record desc="Whether or not to record outgoing messages" default="false">false</record> - </outgoing> - </trace> - - <net desc="Network settings"> - <!-- On systems where localhost resolves to IPv6 [::1] address first, when net.proto is all and net.listen is loopback, loolwsd unexpectedly listens on [::1] only. - You need to change net.proto to IPv4, if you want to use 127.0.0.1. --> - <proto type="string" default="all" desc="Protocol to use IPv4, IPv6 or all for both">all</proto> - <listen type="string" default="any" desc="Listen address that loolwsd binds to. Can be 'any' or 'loopback'.">any</listen> - <service_root type="path" default="" desc="Prefix all the pages, websockets, etc. with this path."></service_root> - <proxy_prefix type="bool" default="false" desc="Enable a ProxyPrefix to be passed int through which to redirect requests"></proxy_prefix> - <post_allow desc="Allow/deny client IP address for POST(REST)." allow="true"> - <host desc="The IPv4 private 192.168 block as plain IPv4 dotted decimal addresses.">192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:192\.168\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="The IPv4 loopback (localhost) address.">127\.0\.0\.1</host> - <host desc="Ditto, but as IPv4-mapped IPv6 address">::ffff:127\.0\.0\.1</host> - <host desc="The IPv6 loopback (localhost) address.">::1</host> - <host desc="The IPv4 private 172.17.0.0/16 subnet (Docker).">172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - <host desc="Ditto, but as IPv4-mapped IPv6 addresses">::ffff:172\.17\.[0-9]{1,3}\.[0-9]{1,3}</host> - </post_allow> - <frame_ancestors desc="Specify who is allowed to embed the LO Online iframe (loolwsd and WOPI host are always allowed). Separate multiple hosts by space."></frame_ancestors> - <connection_timeout_secs desc="Specifies the connection, send, recv timeout in seconds for connections initiated by loolwsd (such as WOPI connections)." type="int" default="30"></connection_timeout_secs> - </net> - - <ssl desc="SSL settings"> - <enable type="bool" desc="Controls whether SSL encryption between browser and loolwsd is enabled (do not disable for production deployment). If default is false, must first be compiled with SSL support to enable." default="true">true</enable> - <termination desc="Connection via proxy where loolwsd acts as working via https, but actually uses http." type="bool" default="true">false</termination> - <cert_file_path desc="Path to the cert file" relative="false">/etc/loolwsd/cert.pem</cert_file_path> - <key_file_path desc="Path to the key file" relative="false">/etc/loolwsd/key.pem</key_file_path> - <ca_file_path desc="Path to the ca file" relative="false">/etc/loolwsd/ca-chain.cert.pem</ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept" default="ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH"></cipher_list> - <hpkp desc="Enable HTTP Public key pinning" enable="false" report_only="false"> - <max_age desc="HPKP's max-age directive - time in seconds browser should remember the pins" enable="true">1000</max_age> - <report_uri desc="HPKP's report-uri directive - pin validation failure are reported at this URL" enable="false"></report_uri> - <pins desc="Base64 encoded SPKI fingerprints of keys to be pinned"> - <pin></pin> - </pins> - </hpkp> - </ssl> - - <security desc="Altering these defaults potentially opens you to significant risk"> - <seccomp desc="Should we use the seccomp system call filtering." type="bool" default="true">true</seccomp> - <capabilities desc="Should we require capabilities to isolate processes into chroot jails" type="bool" default="true">true</capabilities> - <jwt_expiry_secs desc="Time in seconds before the Admin Console's JWT token expires" type="int" default="1800">1800</jwt_expiry_secs> - <enable_macros_execution desc="Specifies whether the macro execution is enabled in general. This will enable Basic, Beanshell, Javascript and Python scripts. If it is set to false, the macro_security_level is ignored. If it is set to true, the mentioned entry specified the level of macro security." type="bool" default="false">{{ item.value.macros.allowed | default(false) | ternary('true', 'false') }}</enable_macros_execution> - <macro_security_level desc="Level of Macro security. 1 (Medium) Confirmation required before executing macros from untrusted sources. 0 (Low, not recommended) All macros will be executed without confirmation." type="int" default="1">{{ item.value.macros.security_level | default('1') }}</macro_security_level> - </security> - - <watermark> - <opacity desc="Opacity of on-screen watermark from 0.0 to 1.0" type="double" default="0.2"></opacity> - <text desc="Watermark text to be displayed on the document if entered" type="string"></text> - </watermark> - - <welcome> - <enable type="bool" desc="Controls whether the welcome screen should be shown to the users on new install and updates." default="true">false</enable> - <enable_button type="bool" desc="Controls whether the welcome screen should have an explanatory button instead of an X button to close the dialog." default="false">false</enable_button> - <path desc="Path to 'welcome-$lang.html' files served on first start or when the version changes. When empty, defaults to the Release notes." type="path" relative="true" default="loleaflet/welcome"></path> - </welcome> - - <user_interface> - <mode type="string" desc="Controls the user interface style (classic|notebookbar)" default="classic">classic</mode> - </user_interface> - - <storage desc="Backend storage"> - <filesystem allow="false" /> - <wopi desc="Allow/deny wopi storage. Mutually exclusive with webdav." allow="true"> - <host desc="Regex pattern of hostname to allow or deny." allow="true">localhost</host> -{% for backend in item.value.backend_storages %} - <host allow="true">{{ backend }}</host> -{% endfor %} - <max_file_size desc="Maximum document size in bytes to load. 0 for unlimited." type="uint">0</max_file_size> - <reuse_cookies desc="When enabled, cookies from the browser will be captured and set on WOPI requests." type="bool" default="false">false</reuse_cookies> - <locking desc="Locking settings"> - <refresh desc="How frequently we should re-acquire a lock with the storage server, in seconds (default 15 mins) or 0 for no refresh" type="int" default="900">900</refresh> - </locking> - </wopi> - <webdav desc="Allow/deny webdav storage. Mutually exclusive with wopi." allow="false"> - <host desc="Hostname to allow" allow="false">localhost</host> - </webdav> - <ssl desc="SSL settings"> - <as_scheme type="bool" default="true" desc="When set we exclusively use the WOPI URI's scheme to enable SSL for storage">true</as_scheme> - <enable type="bool" desc="If as_scheme is false or not set, this can be set to force SSL encryption between storage and loolwsd. When empty this defaults to following the ssl.enable setting"></enable> - <cert_file_path desc="Path to the cert file" relative="false"></cert_file_path> - <key_file_path desc="Path to the key file" relative="false"></key_file_path> - <ca_file_path desc="Path to the ca file. If this is not empty, then SSL verification will be strict, otherwise cert of storage (WOPI-like host) will not be verified." relative="false"></ca_file_path> - <cipher_list desc="List of OpenSSL ciphers to accept. If empty the defaults are used. These can be overriden only if absolutely needed."></cipher_list> - </ssl> - </storage> - - <tile_cache_persistent desc="Should the tiles persist between two editing sessions of the given document?" type="bool" default="true">true</tile_cache_persistent> - - <admin_console desc="Web admin console settings."> - <enable desc="Enable the admin console functionality" type="bool" default="true">true</enable> - <enable_pam desc="Enable admin user authentication with PAM" type="bool" default="false">false</enable_pam> - <username desc="The username of the admin console. Ignored if PAM is enabled.">{{ item.value.admin.username }}</username> - <password desc="The password of the admin console. Deprecated on most platforms. Instead, use PAM or loolconfig to set up a secure password.">{{ item.value.admin.password }}</password> - </admin_console> - - <monitors desc="Addresses of servers we connect to on start for monitoring"> - </monitors> - -</config> diff --git a/roles/apps/collabora/code/templates/nginx-vhost.conf.j2 b/roles/apps/collabora/code/templates/nginx-vhost.conf.j2 deleted file mode 100644 index 67502e20..00000000 --- a/roles/apps/collabora/code/templates/nginx-vhost.conf.j2 +++ /dev/null @@ -1,99 +0,0 @@ -client_max_body_size 128M; - -# static files -{% if item.value.version | collabora_code_loolvcool %} -location ^~ /loleaflet { -{% else %} -location ^~ /browser { -{% endif %} - include snippets/proxy-nobuff.conf; - include snippets/proxy-forward-headers.conf; - - proxy_set_header Host $http_host; - proxy_pass http://127.0.0.1:{{ item.value.port }}; - - proxy_redirect http://$host/ https://$host/; - proxy_redirect http://$host:9980/ https://$host/; -} - -# WOPI discovery URL -location ^~ /hosting/discovery { - include snippets/proxy-nobuff.conf; - include snippets/proxy-forward-headers.conf; - - proxy_set_header Host $http_host; - proxy_pass http://127.0.0.1:{{ item.value.port }}; - - proxy_redirect http://$host/ https://$host/; - proxy_redirect http://$host:9980/ https://$host/; -} - -# Capabilities -location ^~ /hosting/capabilities { - include snippets/proxy-nobuff.conf; - include snippets/proxy-forward-headers.conf; - - proxy_set_header Host $http_host; - proxy_pass http://127.0.0.1:{{ item.value.port }}; - - proxy_redirect http://$host/ https://$host/; - proxy_redirect http://$host:9980/ https://$host/; -} - -# main websocket -{% if item.value.version | collabora_code_loolvcool %} -location ~ ^/lool/(.*)/ws$ { -{% else %} -location ~ ^/cool/(.*)/ws$ { -{% endif %} - include snippets/proxy-nobuff.conf; - include snippets/proxy-forward-headers.conf; - - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection $connection_upgrade; - - proxy_read_timeout 36000s; - - proxy_set_header Host $http_host; - proxy_pass http://127.0.0.1:{{ item.value.port }}; - - proxy_redirect http://$host/ https://$host/; - proxy_redirect http://$host:9980/ https://$host/; -} - -# download, presentation and image upload -{% if item.value.version | collabora_code_loolvcool %} -location ~ ^/lool { -{% else %} -location ~ ^/(c|l)ool { -{% endif %} - include snippets/proxy-nobuff.conf; - include snippets/proxy-forward-headers.conf; - - proxy_set_header Host $http_host; - proxy_pass http://127.0.0.1:{{ item.value.port }}; - - proxy_redirect http://$host/ https://$host/; - proxy_redirect http://$host:9980/ https://$host/; -} - -# Admin Console websocket -{% if item.value.version | collabora_code_loolvcool %} -location ^~ /lool/adminws { -{% else %} -location ^~ /cool/adminws { -{% endif %} - include snippets/proxy-nobuff.conf; - include snippets/proxy-forward-headers.conf; - - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection $connection_upgrade; - - proxy_read_timeout 36000s; - - proxy_set_header Host $http_host; - proxy_pass http://127.0.0.1:{{ item.value.port }}; - - proxy_redirect http://$host/ https://$host/; - proxy_redirect http://$host:9980/ https://$host/; -} diff --git a/roles/apps/collabora/code/templates/pod-spec.yml.j2 b/roles/apps/collabora/code/templates/pod-spec.yml.j2 deleted file mode 100644 index 22dfaf49..00000000 --- a/roles/apps/collabora/code/templates/pod-spec.yml.j2 +++ /dev/null @@ -1,30 +0,0 @@ -containers: -- name: collabora-code - image: "collabora/code{% if 'custom_image' in item.value %}/{{ item.key }}{% endif %}:{{ item.value.version }}" - resources: - limits: - memory: "4Gi" - env: - - name: "DONT_GEN_SSL_CERT" - value: "1" - - name: "extra_params" - value: "--o:ssl.enable=false --o:ssl.termination=true" - volumeMounts: - - name: config -{% if item.value.version | collabora_code_loolvcool %} - mountPath: /etc/loolwsd/loolwsd.xml - subPath: loolwsd.xml -{% else %} - mountPath: /etc/coolwsd/coolwsd.xml - subPath: coolwsd.xml -{% endif %} - readOnly: true - ports: - - containerPort: 9980 - hostPort: {{ item.value.port }} - hostIP: 127.0.0.1 -volumes: -- name: config - hostPath: - path: "{{ collabora_code_base_path }}/{{ item.key }}/config/" - type: Directory |