Configuration

After installing the Euro-Office Document Server, install the Nextcloud connector app and connect it to the server.

Installing the connector app

Install the Euro-Office app from the Nextcloud App Store:

1. Open Settings → Apps in your Nextcloud admin interface.
2. Search for Euro-Office.
3. Click Download and enable.

Alternatively, install the app using the occ command:

sudo -E -u www-data php occ app:install eurooffice

Server settings

Open Settings → Administration → Euro-Office to configure the connection.

Nextcloud Office address
The URL of the Euro-Office Document Server, accessible from both the Nextcloud server and end-user browsers:

https://<documentserver>/

Disable certificate verification (insecure)
Disables TLS certificate checks. Only enable this in test environments.

Secret key (leave blank to disable)
The JWT shared secret. Must match the value configured on the Document Server:

• deb/rpm install: /etc/euro-office/documentserver/local.json → services.CoAuthoring.secret.browser.string
• Docker install: the JWT_SECRET environment variable

Click Save to apply. A green status indicator confirms a successful connection.

Advanced server settings

Expand Advanced server settings when the public Document Server URL is not directly reachable from your Nextcloud host (for example, behind a NAT or split-horizon DNS):

Authorization header (leave blank to use default header)
The HTTP header used to carry the JWT token. Defaults to Authorization.

Nextcloud Office address for internal requests from the server
The URL Nextcloud uses to contact the Document Server directly (server-to-server). Must be reachable from the Nextcloud host.

Server address for internal requests from Nextcloud Office
The URL the Document Server uses to send callbacks back to Nextcloud. Must be reachable from the Document Server host.

提示

Docker Compose example

When Nextcloud and Euro-Office run as services in the same Docker Compose network, containers can reach each other by service name. Given a compose.yml with services named nextcloud and eurooffice:

• Nextcloud Office address (public): https://office.example.com/
• Nextcloud Office address for internal requests from the server: http://eurooffice/
• Server address for internal requests from Nextcloud Office: http://nextcloud/

The public address is used by end-user browsers. The internal addresses bypass the public reverse proxy and let the two containers communicate directly over the shared Docker network.

Common settings

These settings become available after a successful server connection.

Default application for opening the format
Checkboxes for each supported file format. When enabled for a format, Nextcloud Office becomes the default handler when that file type is clicked.

Open the file for editing
Checkboxes for formats that can be edited natively. Enabling a format allows users to edit it directly. Note that saving back to some formats may result in data loss due to format restrictions.

Editor customization settings

REVIEW mode for viewing
Default mode for displaying tracked changes: Markup, Final, or Original.

Default editor theme
Color theme for the editor interface: Same as system, Light, or Dark.

Common templates

Administrators can upload shared document templates that are available to all users when creating new files. Templates are managed in the Common templates section of the admin settings page.

Security

Enable plugins
Allows third-party plugins to run inside the editor.

Run document macros
Allows macros embedded in documents to execute.

Enable document protection for
Controls who can protect or unprotect documents:

• All users — any editor can protect or unprotect the document.
• Owner only — only the file owner can change protection.

Watermarks

Watermarks are overlaid on documents when they are opened by specified users or via shares. Enable Enable watermarking to configure the watermark.

Watermark text — the text overlaid on the document. Supported placeholders:

• {userId} — Nextcloud user ID
• {userDisplayName} — user's display name
• {email} — user's e-mail address
• {date} — current date
• {themingName} — Nextcloud instance name from theming settings

Watermark visibility can be configured per audience:

occ commands

Settings can also be managed via occ:

# Read a setting
sudo -E -u www-data php occ config:app:get eurooffice DocumentServerUrl

# Write a setting
sudo -E -u www-data php occ config:app:set eurooffice DocumentServerUrl --value="https://office.example.com/"

The eurooffice:documentserver command shows the configured server URL and optionally tests the connection:

# Print the currently configured Document Server URL
sudo -E -u www-data php occ eurooffice:documentserver

# Check the connection to the Document Server
sudo -E -u www-data php occ eurooffice:documentserver --check

config.php

Settings can also be set directly in config/config.php under the eurooffice key:

"eurooffice" => [
    "DocumentServerUrl" => "https://office.example.com/",
    "jwt_secret" => "your-secret",
    "verify_peer_off" => "true",
],

提示

verify_peer_off is read as a string — use "true" to disable certificate verification, not a PHP boolean.

Settings defined in config.php are used as fallback when no value is set via the admin UI or occ. The UI takes precedence.