# Collabora •

[Collabora](https://www.collaboraonline.com/) is an open-source and self-hosted office suite that enables you to edit documents, spreadsheets and presentations directly in your web-browser.

# Overview

[![Screen Shot 2025-03-07 at 16.16.05.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-07-at-16-16-05.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-07-at-16-16-05.png)

[Collabora](https://www.collaboraonline.com/) is an open-source and self-hosted office suite that enables you to edit documents, spreadsheets and presentations directly in your web-browser.

- Supports all major document, spreadsheet and presentation formats – including Microsoft and Open Documents.
- Create with friends and family in real-time using secure collaborative tools.
- Compatible with desktop and mobile applications to provide a cohesive experience.

# Media

## Screenshots

<p class="callout info">OwnCloud v10.10.5</p>

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; border-width: 1px; height: 59.6px; border-color: rgb(88, 110, 117);"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-07 at 16.16.05.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-07-at-16-16-05.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-07-at-16-16-05.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-07 at 16.16.17.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-07-at-16-16-17.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-07-at-16-16-17.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-07 at 16.17.42.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-07-at-16-17-42.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-07-at-16-17-42.png)</td></tr><tr style="height: 29.8px;"><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-07 at 16.24.26.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-07-at-16-24-26.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-07-at-16-24-26.png)</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td><td style="border-width: 1px; height: 29.8px; border-color: rgb(88, 110, 117);">  
</td></tr></tbody></table>

# 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

<details id="bkmrk-tz-this-is-the-curre"><summary>DOMAIN</summary>

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

<p class="callout info">*For example:* collabora.example.com</p>

</details><details id="bkmrk-gid-%C2%A0"><summary>ALIASGROUP1</summary>

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

<p class="callout info">*For example:* owncloud.example.com</p>

</details><details id="bkmrk-pgid-this-is-the-num"><summary>USERNAME</summary>

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

<p class="callout info">*For example:* owncloud</p>

</details>### Passwords

<p class="callout danger">Keep these securely stored in a password manager, such as [VaultWarden](https://hub.subspace.services/books/vaultwarden "VaultWarden").</p>

<details id="bkmrk-password-this-is-the"><summary>PASSWORD</summary>

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

<p class="callout warning">It is important to use secure, randomly generated password.</p>

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

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

This pulls a random string from the '[urandom](https://en.wikipedia.org/wiki//dev/random)' device, removes unwanted characters and trim it to an appropriate length.

</details>

# Installation

The service can be installed through the Portainer web interface.

<p class="callout info">Learn about [creating a new stack](https://hub.subspace.services/books/portainer/page/creating-a-new-stack "Creating a New Stack").</p>

## Docker Compose

Use the following code to install the service:

```yaml
---
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

<p class="callout success">Re-Deploy the Stack</p>

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](https://hub.subspace.services/books/portainer/page/updating-a-stack "Updating a Stack") to download the latest updates.

# User Manual

# Development

<p class="callout info">This software is released under the [MPL-2.0 license](https://opensource.org/license/mpl-2-0). </p>

You can learn more about how to contribute to Collabora through their [GitHub repository](https://github.com/CollaboraOnline/online/blob/master/CONTRIBUTING.md).

# Resources

## Official

- [Official Documentation](https://sdk.collaboraonline.com/)
- [Official Forum](https://forum.collaboraonline.com/)
- [Official GitHub Repository](https://github.com/CollaboraOnline/online)
- [Official Website](https://www.collaboraonline.com/)
- [Installation Guide](https://sdk.collaboraonline.com/docs/installation/index.html)
- [Troubleshooting Guide](https://sdk.collaboraonline.com/docs/installation/Collabora_Online_Troubleshooting_Guide.html)
- [Frequently Asked Questions](https://www.collaboraonline.com/faqs/)