Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

Preparation

There are some things we need to do in preparation to install this service.

Environment

General

DOMAIN

This is the full domain and sub-domain that the service will be available at.

For example: collabora.example.com

ALIASGROUP1

This is the full domain and sub-domain for your OwnCloud installation, allowing you to integrate the two services.

For example: owncloud.example.com

USERNAME

This is the username used by the OwnCloud service to connect with the Collabora service. 

For example: owncloud

Passwords

Keep these securely stored in a password manager, such as VaultWarden.

PASSWORD

This is the password that will be used for root access to the database.

It is important to use secure, randomly generated password.

You can use a random alphanumeric string from a password manager, or open the terminal and run the command:

tr -dc 'A-Za-z0-9!"#$%&'\''()*+,-./:;<=>?@[\]^_`{|}~' </dev/urandom | head -c 32; echo

This pulls a random string from the 'urandom' device, removes unwanted characters and trim it to an appropriate length.


Installation

The service can be installed through the Portainer web interface. 

Learn about creating a new stack.

Docker Compose

Use the following code to install the service:

---
services:
  collabora:
    image: collabora/code
    container_name: collabora
    hostname: collabora
    ports:
      - 9980:9980
    environment:
      - DOMAIN=collabora.example.com
      - ALIASGROUP1=owncloud.example.com
      - USERNAME=owncloud
      - PASSWORD=
    restart: unless-stopped

Updating

Re-Deploy the Stack

Collabora has been optimized for running in Docker and does not store any persistent data. 

This allows you to re-deploy the stack through Portainer to download the latest updates.