Community Knowledge Base

Collabora

Collabora is a complete office suite that allows users to view, edit, and collaborate on documents, spreadsheets, and presentations. When enabled, SmarterMail users can utilize their own or their organization’s Collabora installation to edit files stored in File Storage or create new files that are automatically saved in their File Storage area. They can also use Collabora to view attachments, based on the supported file types. (E.g., .txt, .docx, .xls, etc.)

screen shot of configuring OpenOffice

In order to set up Collabora for a domain, you will need to Enable Collabora Integration for the domain, then configure the following:

  • Collabora Server URL - This is the full URL to the Collabora server. It can be a FQDN (e.g., collabora.some-domain.com) or an IP address.
  • Max Connections (0 = Unlimited) - This is the maximum number of connections the domain can make to the specified Collabora server.

    Note: The number of max connections to a single Collabora server can vary by license.
  • Max Connections for Each User (0 = Unlimited - This is the maximum number of connections a single user can make to the specified Collabora server. As such, it works in conjunction with the Max Connections setting.

Collabora Tips

  1. If the customer has Collabora running on a different domain than SmarterMail, the x-frame-src header will need to be removed on the Collabora server.
  2. When working with Collabora Community Server, be sure to include "/ds-vpath" at the end of the Collabora URL. (If NOT using Community Server, this may not be necessary.)

Using Collabora

Collabora is a complete office suite that gives users the ability to view, edit, and collaborate on documents, spreadsheets, and presentation decks. The online version can be integrated with SmarterMail's File Storage area, so SmarterMail users can edit files currently stored in File Storage, or even create new files and have them stored automatically, using their own installation of Collabora Online.

Note: The integration of an organization's Collabora server is handled, and initiated, at the System Administrator level. If your organization has an Collabora server, but you do not have the option to create or edit files using Collabora Online, check with your SmarterMail administrator.

Creating New Collabora Files

Creating a new file using Collabora is extremely simple: just use the New button and select the type of file you want to create:

Creating a new Collabora file

Once you've made your choice, the New Document modal will open, allowing you to name your file, select (or change) the type of file you want to create, and then select where you want the new file to be stored. Once done, click the Save button and the new file is created, and a new browser tab opens so you can begin editing your new file.

Note: Based on Collabora's configuration it's only possible to have a maximum of 20 "sessions" open at one time per Collabora document server.

Editing Existing Files

Editing an existing file is just as easy. Simply click the Actions (⋮) button on any text file, document, spreadsheet, or presentation, and select Edit with Collabora Online from the menu options. The Collabora editor will open in a new browser tab, and you can edit to your heart's content.

Worth Noting

There are a few things worth noting regarding the integration of Collabora:

  • Depending on licensing, Collabora Online sessions may be limited. If so, the system administrator will need to know that when setting up the integration. They also have the ability to set the maximum number of sessions any one user can have open at a time.
  • Collabora has an automated save and timeout feature that cannot be controlled by SmarterMail. By default, if a file is open in a tab for more than 60 minutes, without any session activity, it will automatically save and the session will time out.
  • If SmarterMail goes down when a file is open, the file will appear in File Storage with a warning icon on it. When you open the file, you're presented with some recovery options. (Recover document and overwrite, rename and recover document, Download, or Delete the recovered copy.)