mash-playbook/docs/services/collabora-online.md

# Collabora Online

The [Collabora Online Development Edition (CODE)](https://www.collaboraoffice.com/) office suite, together with the [Office App](https://apps.nextcloud.com/apps/richdocuments) for [Nextcloud](nextcloud.md) enables you to edit office documents online.


## Dependencies

This service requires the following other services:

- a [Postgres](postgres.md) database
- a [Traefik](traefik.md) reverse-proxy server


## Configuration

To enable this service, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:

```yaml
########################################################################
#                                                                      #
# collabora-online                                                     #
#                                                                      #
########################################################################

collabora_online_enabled: true

collabora_online_hostname: collabora.example.com

# A password for the admin interface, available at: https://COLLABORA_ONLINE_DOMAIN/browser/dist/admin/admin.html
# Use only alpha-numeric characters
collabora_online_env_variable_password: ''

collabora_online_aliasgroup: "https://{{ nextcloud_hostname | replace('.', '\\.') }}:443"

########################################################################
#                                                                      #
# /collabora-online                                                    #
#                                                                      #
########################################################################
```

In the example configuration above, we configure the service to be hosted at `https://collabora.example.com`.


## Integrating with Nextcloud

To learn how to integrate Collabora Online with Nextcloud, see the [Collabora Online section](nextcloud.md#collabora-online) in our Nextcloud documentation.


## Admin Interface

There's an admin interface with various statistics and information at: `https://COLLABORA_ONLINE_DOMAIN/browser/dist/admin/admin.html`

Use your admin credentials for logging in:

- the default username is `admin`, as specified in `collabora_online_env_variable_username`
- the password is the one you've specified in `collabora_online_env_variable_password`
Add Collabora Online support 2023-03-17 13:25:31 +01:00			`# Collabora Online`

			`The [Collabora Online Development Edition (CODE)](https://www.collaboraoffice.com/) office suite, together with the [Office App](https://apps.nextcloud.com/apps/richdocuments) for [Nextcloud](nextcloud.md) enables you to edit office documents online.`


			`## Dependencies`

			`This service requires the following other services:`

			`- a [Postgres](postgres.md) database`
			`- a [Traefik](traefik.md) reverse-proxy server`


			`## Configuration`

			To enable this service, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:

			```yaml
			`########################################################################`
			`# #`
			`# collabora-online #`
			`# #`
			`########################################################################`

			`collabora_online_enabled: true`

			`collabora_online_hostname: collabora.example.com`

			`# A password for the admin interface, available at: https://COLLABORA_ONLINE_DOMAIN/browser/dist/admin/admin.html`
docs(collabora-online): Add info to use alphanumeric caracters More complex passwords containing some special characters might trigger [ coolwsd ] FTL Failed to initialize COOLWSD: SAXParseException: Invalid token in '/etc/coolwsd/coolwsd.xml', line 244 column 167 2024-01-03 16:49:46 +01:00			`# Use only alpha-numeric characters`
Add Collabora Online support 2023-03-17 13:25:31 +01:00			`collabora_online_env_variable_password: ''`

			`collabora_online_aliasgroup: "https://{{ nextcloud_hostname \| replace('.', '\\.') }}:443"`

			`########################################################################`
			`# #`
			`# /collabora-online #`
			`# #`
			`########################################################################`
			```

			In the example configuration above, we configure the service to be hosted at `https://collabora.example.com`.


			`## Integrating with Nextcloud`

			`To learn how to integrate Collabora Online with Nextcloud, see the [Collabora Online section](nextcloud.md#collabora-online) in our Nextcloud documentation.`


			`## Admin Interface`

			There's an admin interface with various statistics and information at: `https://COLLABORA_ONLINE_DOMAIN/browser/dist/admin/admin.html`

			`Use your admin credentials for logging in:`

			- the default username is `admin`, as specified in `collabora_online_env_variable_username`
			- the password is the one you've specified in `collabora_online_env_variable_password`