Setting up and configuring native CODE packages on Linux

Collabora provide native Linux packages for selected Linux distributions: Debian 9, Debian 10, Ubuntu 16.04, Ubuntu 18.04, Ubuntu 20.04, CentOS 7 (at least 7.2), CentOS 8, SLE 15.x and openSUSE Leap 15.x.

1. Import the signing key

CODE packages are digitally signed by Collabora Productivity Ltd. First step is to import the signing key.

On deb based distributions (Debian, Ubuntu), use the following command:

cd /usr/share/keyrings
sudo wget https://collaboraoffice.com/downloads/gpg/collaboraonline-release-keyring.gpg

On rpm based distributions (CentOS, openSUSE), use the following command:

wget https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-centos7/repodata/repomd.xml.key && sudo rpm --import repomd.xml.key

2. Add CODE package repositories

On deb based distributions (Debian, Ubuntu), create /etc/apt/sources.list.d/collaboraonline.sources with the following contents:

Debian 9:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-debian9
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

Debian 10:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-debian10
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

Debian 11:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-debian11
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

Ubuntu 16.04:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

Ubuntu 18.04:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-ubuntu1804
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

Ubuntu 20.04:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-ubuntu2004
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

Ubuntu 22.04:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-ubuntu2204
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

ARM64 – Ubuntu 18.04:

Types: deb
URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-arm64-ubuntu1804
Suites: ./
Signed-By: /usr/share/keyrings/collaboraonline-release-keyring.gpg

On rpm based distros (CentOS, RHEL, SUSE), use the following commands:

CentOS 7:

sudo yum-config-manager --add-repo https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-centos7

CentOS 8:

sudo yum-config-manager --add-repo https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-centos8

openSUSE Leap 15.x (and SLE 15):

sudo zypper ar 'https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-opensuse15' 'CODE'
sudo zypper mr -r 'CODE' # enable auto refresh

3. Install packages

On deb based distributions (Debian, Ubuntu), use the following command:

sudo apt update && sudo apt install coolwsd code-brand

On CentOS, use the following command:

sudo yum install coolwsd CODE-brand

On openSUSE Leap, use the following command:

sudo zypper ref && sudo zypper in coolwsd CODE-brand

This is the minimal installation, without localizations. For full installation install ‘collaboraoffice*’ packages.

4. Configuration

Edit /etc/coolwsd/coolwsd.xml. Collabora Online (coolwsd) service runs via systemd. After editing the configuration file, you have to restart the service:

sudo systemctl restart coolwsd

Collabora Online logs into systemd journal by default. You can check the log with:

sudo journalctl -u coolwsd

The default configuration is looking for an SSL certificate and key, which are not present, so probably it’s the best to disable SSL, and optionally enable SSL termination, then set up the reverse proxy.