Collaborative editing

Collabora Online🔗

Collabora Online is a self-hosted office suite that runs in the browser. With it, FileRun can preview, create and edit text documents, spreadsheets and presentations, with several people editing the same file at once.

Read Collaborative editing first: it explains the settings this plugin shares with the other editors you install yourself, including the rule that the editor's protocol has to match FileRun's.

Step 1: Install the Collabora Online server🔗

Follow Collabora's own installation guide.

For a quick trial with Docker:

 1docker run --detach --publish 9980:9980 --env "extra_params=--o:ssl.enable=false" --env "aliasgroup1=https://your-filerun-server:443" collabora/code

Replace your-filerun-server with the address of your FileRun installation. aliasgroup1 tells Collabora which host it is allowed to serve documents for; without a matching entry it refuses the request.

Note

This command disables SSL inside the container, so the editor answers on plain http://. That matches a FileRun installation running on http://. For a FileRun installation on https://, the editor has to be served over https:// as well, normally by putting it behind a reverse proxy that holds the certificate.

Step 2: Configure the FileRun plugin🔗

Open the control panel, go to Files → Plugins, select Collabora and click Edit.

• Document editing service URL — the address of the Collabora server, for example http://localhost:9980.
• Verify SSL certificate — leave it on unless the editor uses a certificate your FileRun server does not trust.
• Compact mode — hides part of the editor's toolbar, leaving more room for the document.

Save. FileRun contacts the server and confirms with Document editing service successfully validated!.

Step 3: Choose when it is used🔗

To make Collabora the editor that opens when a user double-clicks an office document, set it as the default under Files → Plugins → Defaults. Otherwise it is offered in the Open with.. menu.