From 246a3fbd560bb4946c128017391e6f918b732893 Mon Sep 17 00:00:00 2001 From: Julius Knorr Date: Fri, 23 Oct 2026 16:24:25 +0200 Subject: [PATCH 1/2] docs(office): install from Nextcloud Office packages Assisted-by: ClaudeCode:claude-opus-5-5 Signed-off-by: Julius Knorr --- .../_nextcloud_office_apt_repository.rst | 12 ++ admin_manual/contents.rst | 4 +- .../office/euro-office/configuration.rst | 4 +- admin_manual/office/euro-office/index.rst | 3 +- .../euro-office/installation_debian.rst | 40 +++---- .../euro-office/installation_ubuntu.rst | 37 +++--- admin_manual/office/index.rst | 11 +- user_manual/contents.rst | 1 + user_manual/office_desktop_editors.rst | 106 ++++++++++++++++++ 9 files changed, 167 insertions(+), 51 deletions(-) create mode 100644 _shared_assets/_nextcloud_office_apt_repository.rst create mode 100644 user_manual/office_desktop_editors.rst diff --git a/_shared_assets/_nextcloud_office_apt_repository.rst b/_shared_assets/_nextcloud_office_apt_repository.rst new file mode 100644 index 00000000000..6f0e30518bb --- /dev/null +++ b/_shared_assets/_nextcloud_office_apt_repository.rst @@ -0,0 +1,12 @@ +.. Shared code block that adds the Nextcloud Office apt repository on Debian and Ubuntu. + +.. code-block:: bash + + sudo apt-get install -y ca-certificates curl + sudo install -d -m 0755 /etc/apt/keyrings + sudo curl -fsSL https://download.nextcloud.com/office/repo/nextcloud-office.asc \ + -o /etc/apt/keyrings/nextcloud-office.asc + echo "deb [signed-by=/etc/apt/keyrings/nextcloud-office.asc] \ + https://download.nextcloud.com/office/repo/deb stable main" \ + | sudo tee /etc/apt/sources.list.d/nextcloud-office.list + sudo apt-get update diff --git a/admin_manual/contents.rst b/admin_manual/contents.rst index a7dc2fff270..0df3f466626 100644 --- a/admin_manual/contents.rst +++ b/admin_manual/contents.rst @@ -68,7 +68,9 @@ Table of contents .. toctree:: :caption: Office - office/index + Overview + office/euro-office/index + office/collabora_online .. toctree:: :caption: Collectives diff --git a/admin_manual/office/euro-office/configuration.rst b/admin_manual/office/euro-office/configuration.rst index bb67b39fc0b..21c93896e26 100644 --- a/admin_manual/office/euro-office/configuration.rst +++ b/admin_manual/office/euro-office/configuration.rst @@ -8,7 +8,7 @@ and connect it to the server. Installing the connector app ----------------------------- -Install the **Euro-Office** app from the Nextcloud App Store: +Install the `Euro-Office connector app `_ from the Nextcloud App Store: 1. Open :menuselection:`Settings --> Apps` in your Nextcloud admin interface. 2. Search for **Euro-Office**. @@ -39,7 +39,7 @@ Open :menuselection:`Settings --> Administration --> Euro-Office` to configure t **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`` → + - **deb/rpm install:** ``/etc/nextcloud-office/documentserver/local.json`` → ``services.CoAuthoring.secret.browser.string`` - **Docker install:** the ``JWT_SECRET`` environment variable diff --git a/admin_manual/office/euro-office/index.rst b/admin_manual/office/euro-office/index.rst index 4cfc00bcbfa..a71a4b3c664 100644 --- a/admin_manual/office/euro-office/index.rst +++ b/admin_manual/office/euro-office/index.rst @@ -12,7 +12,8 @@ and many more. .. note:: A dedicated Document Server is required for production use. Install the server first, then - connect Nextcloud to it using the **Euro-Office** connector app. + connect Nextcloud to it using the + `Euro-Office connector app `_. .. toctree:: :maxdepth: 2 diff --git a/admin_manual/office/euro-office/installation_debian.rst b/admin_manual/office/euro-office/installation_debian.rst index cb362f72360..3474f4792f2 100644 --- a/admin_manual/office/euro-office/installation_debian.rst +++ b/admin_manual/office/euro-office/installation_debian.rst @@ -2,8 +2,8 @@ Installing on Debian 12 ========================== -This guide covers installing Euro-Office Document Server on Debian 12 (Bookworm) -from a GitHub release package. +This guide covers installing the Nextcloud Office Document Server on Debian 12 (Bookworm) +from the Nextcloud Office package repository. System requirements ------------------- @@ -15,7 +15,7 @@ System requirements Step 1 — Enable the contrib component -------------------------------------- -The ``ttf-mscorefonts-installer`` package required by Euro-Office lives in Debian's +The ``ttf-mscorefonts-installer`` package required by the Document Server lives in Debian's ``contrib`` component, which is not enabled by default. Edit ``/etc/apt/sources.list`` and add ``contrib`` to each line: @@ -34,8 +34,7 @@ Then update the package index: Step 2 — Install prerequisites ------------------------------- -All prerequisites are available in the default Debian 12 repositories — no extra -package sources are required: +All prerequisites are available in the default Debian 12 repositories: .. code-block:: bash @@ -64,28 +63,29 @@ Step 4 — Pre-seed the installer answers ds ds/db-pwd password ds ds ds/db-name string ds" | sudo debconf-set-selections -Step 5 — Download the package ------------------------------- +Step 5 — Add the Nextcloud Office repository +-------------------------------------------- -Download the latest release from `GitHub Releases `_: +Add the signing key and the package repository so that updates arrive with regular system updates: -.. code-block:: bash - - # Replace and with your values, e.g. 9.3.1 and amd64 or arm64 - wget "https://github.com/Euro-Office/DocumentServer/releases/download/v/euro-office-documentserver__.deb" \ - -O /tmp/euro-office-documentserver.deb +.. include:: ../../../_shared_assets/_nextcloud_office_apt_repository.rst Step 6 — Install the package ----------------------------- .. code-block:: bash - sudo apt-get install -y /tmp/euro-office-documentserver.deb + sudo apt-get install -y nextcloud-office-documentserver + +.. tip:: + For hosts without access to the repository, or to install a specific version, download the + ``.deb`` package from https://download.nextcloud.com/office/docserver/ and install it with + ``sudo apt-get install -y ./.deb``. The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two. A successful install ends with:: - Congratulations, the Euro-Office DocumentServer has been installed successfully! + Congratulations, the Nextcloud Office DocumentServer has been installed successfully! Step 7 — Verify ---------------- @@ -114,19 +114,19 @@ Expected output: ``true`` Updating -------- -Download the new release package and reinstall: +Updates are installed with the regular system updates. To update only the Document Server: .. code-block:: bash - wget "https://github.com/Euro-Office/DocumentServer/releases/download/v/euro-office-documentserver__.deb" \ - -O /tmp/euro-office-documentserver.deb - sudo apt-get install -y /tmp/euro-office-documentserver.deb + sudo apt-get update + sudo apt-get install --only-upgrade nextcloud-office-documentserver Uninstalling ------------ .. code-block:: bash - sudo apt-get remove --purge euro-office-documentserver + sudo apt-get remove --purge nextcloud-office-documentserver sudo -u postgres psql -c "DROP DATABASE ds;" sudo -u postgres psql -c "DROP USER ds;" + sudo rm /etc/apt/sources.list.d/nextcloud-office.list /etc/apt/keyrings/nextcloud-office.asc diff --git a/admin_manual/office/euro-office/installation_ubuntu.rst b/admin_manual/office/euro-office/installation_ubuntu.rst index 4aea9dbf816..e3a5863432c 100644 --- a/admin_manual/office/euro-office/installation_ubuntu.rst +++ b/admin_manual/office/euro-office/installation_ubuntu.rst @@ -2,8 +2,8 @@ Installing on Ubuntu 24.04 LTS ============================== -This guide covers installing Euro-Office Document Server on Ubuntu 24.04 LTS (Noble) -from a GitHub release package. +This guide covers installing the Nextcloud Office Document Server on Ubuntu 24.04 LTS (Noble) +from the Nextcloud Office package repository. System requirements ------------------- @@ -15,7 +15,7 @@ System requirements Step 1 — Install prerequisites ------------------------------- -Euro-Office requires PostgreSQL, Redis, RabbitMQ, Nginx, and Supervisor. Install them +The Document Server requires PostgreSQL, Redis, RabbitMQ, Nginx, and Supervisor. Install them before the package: .. code-block:: bash @@ -49,28 +49,29 @@ database connection details so the post-install script can proceed without a pro ds ds/db-pwd password ds ds ds/db-name string ds" | sudo debconf-set-selections -Step 4 — Download the package ------------------------------- +Step 4 — Add the Nextcloud Office repository +-------------------------------------------- -Download the latest release from `GitHub Releases `_: +Add the signing key and the package repository so that updates arrive with regular system updates: -.. code-block:: bash - - # Replace and with your values, e.g. 9.3.1 and amd64 or arm64 - wget "https://github.com/Euro-Office/DocumentServer/releases/download/v/euro-office-documentserver__.deb" \ - -O /tmp/euro-office-documentserver.deb +.. include:: ../../../_shared_assets/_nextcloud_office_apt_repository.rst Step 5 — Install the package ----------------------------- .. code-block:: bash - sudo apt-get install -y /tmp/euro-office-documentserver.deb + sudo apt-get install -y nextcloud-office-documentserver + +.. tip:: + For hosts without access to the repository, or to install a specific version, download the + ``.deb`` package from https://download.nextcloud.com/office/docserver/ and install it with + ``sudo apt-get install -y ./.deb``. The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two. A successful install ends with:: - Congratulations, the Euro-Office DocumentServer has been installed successfully! + Congratulations, the Nextcloud Office DocumentServer has been installed successfully! Step 6 — Verify ---------------- @@ -99,19 +100,19 @@ Expected output: ``true`` Updating -------- -Download the new release package and reinstall: +Updates are installed with the regular system updates. To update only the Document Server: .. code-block:: bash - wget "https://github.com/Euro-Office/DocumentServer/releases/download/v/euro-office-documentserver__.deb" \ - -O /tmp/euro-office-documentserver.deb - sudo apt-get install -y /tmp/euro-office-documentserver.deb + sudo apt-get update + sudo apt-get install --only-upgrade nextcloud-office-documentserver Uninstalling ------------ .. code-block:: bash - sudo apt-get remove --purge euro-office-documentserver + sudo apt-get remove --purge nextcloud-office-documentserver sudo -u postgres psql -c "DROP DATABASE ds;" sudo -u postgres psql -c "DROP USER ds;" + sudo rm /etc/apt/sources.list.d/nextcloud-office.list /etc/apt/keyrings/nextcloud-office.asc diff --git a/admin_manual/office/index.rst b/admin_manual/office/index.rst index c0234288987..b1099c25811 100644 --- a/admin_manual/office/index.rst +++ b/admin_manual/office/index.rst @@ -4,12 +4,12 @@ Office Nextcloud supports two office solutions for collaborative document editing: -**Nextcloud Office** (powered by Euro-Office) +**Nextcloud Office** (powered by Euro-Office, see :doc:`euro-office/index`) The default office solution built into Nextcloud. Enables real-time collaborative editing of text documents, spreadsheets, and presentations with high-fidelity rendering. Requires a Euro-Office Document Server. -**Collabora Online** +**Collabora Online** (see :doc:`collabora_online`) A fully supported alternative based on the Collabora Online Development Edition (CODE). Available as a self-hosted server or as a built-in app. Enterprise users can use the more stable Collabora Online Enterprise through a @@ -17,10 +17,3 @@ Nextcloud supports two office solutions for collaborative document editing: Both solutions support dozens of document formats including DOC, DOCX, PPT, PPTX, XLS, XLSX, ODF and many more. - -.. toctree:: - :maxdepth: 2 - :includehidden: - - euro-office/index - collabora_online diff --git a/user_manual/contents.rst b/user_manual/contents.rst index 5a49ab342d2..a4c84d08e08 100644 --- a/user_manual/contents.rst +++ b/user_manual/contents.rst @@ -16,6 +16,7 @@ Table of contents talk/index collectives/index desktop/index + office_desktop_editors userpreferences universal_access user_2fa diff --git a/user_manual/office_desktop_editors.rst b/user_manual/office_desktop_editors.rst new file mode 100644 index 00000000000..bbb23e7b17f --- /dev/null +++ b/user_manual/office_desktop_editors.rst @@ -0,0 +1,106 @@ +======================== +Nextcloud Office Desktop +======================== + +Nextcloud Office Desktop lets you edit documents, spreadsheets, and presentations offline on your computer. +The download links below always point to the latest stable release. Older versions are available from +https://download.nextcloud.com/office/desktopeditors/. + +Windows and macOS +----------------- + +.. list-table:: + :header-rows: 1 + + * - Platform + - Architecture + - Download + * - Windows + - x64 + - `Installer (.exe) `__ + * - Windows + - ARM64 + - `Installer (.exe) `__ + * - macOS + - Apple Silicon + - `Disk image (.dmg) `__ + +Linux +----- + +Install from the Nextcloud Office package repository, so that updates arrive with regular system updates. + +Debian and Ubuntu +^^^^^^^^^^^^^^^^^ + +.. include:: ../_shared_assets/_nextcloud_office_apt_repository.rst + +.. code-block:: bash + + sudo apt-get install nextcloud-office-nextcloudoffice + +Fedora and RHEL +^^^^^^^^^^^^^^^ + +.. code-block:: bash + + sudo tee /etc/yum.repos.d/nextcloud-office.repo <<'EOF' + [nextcloud-office] + name=Nextcloud Office + baseurl=https://download.nextcloud.com/office/repo/rpm/stable/$basearch + enabled=1 + gpgcheck=1 + repo_gpgcheck=1 + gpgkey=https://download.nextcloud.com/office/repo/nextcloud-office.asc + EOF + sudo dnf install nextcloud-office-nextcloudoffice + +Individual packages +^^^^^^^^^^^^^^^^^^^ + +If you cannot use the package repository, download a package directly. These packages are not updated +automatically. + +.. list-table:: + :header-rows: 1 + + * - Distribution + - Architecture + - Download + * - Debian, Ubuntu + - x64 + - `.deb `__ + * - Debian, Ubuntu + - ARM64 + - `.deb `__ + * - Fedora, RHEL, openSUSE + - x64 + - `.rpm `__ + * - Fedora, RHEL, openSUSE + - ARM64 + - `.rpm `__ + * - Any distribution (portable) + - x64 + - `.tar.xz `__ + * - Any distribution (portable) + - ARM64 + - `.tar.xz `__ + +.. _nco-windows-x64.exe: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-windows-x64.exe +.. _nco-windows-arm64.exe: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-windows-arm64.exe +.. _nco-macos-arm64.dmg: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-macos-arm64.dmg +.. _nco-linux-x64.deb: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-x64.deb +.. _nco-linux-arm64.deb: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-arm64.deb +.. _nco-linux-x64.rpm: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-x64.rpm +.. _nco-linux-arm64.rpm: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-arm64.rpm +.. _nco-linux-x64.tar.xz: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-x64.tar.xz +.. _nco-linux-arm64.tar.xz: + https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-arm64.tar.xz From 861f837475c47b2bc3042dc7e6a166c582d5552a Mon Sep 17 00:00:00 2001 From: Julius Knorr Date: Sat, 24 Oct 2026 22:15:07 +0200 Subject: [PATCH 2/2] docs(office): preseed fonts EULA and install only from the repository Assisted-by: ClaudeCode:claude-opus-5-5 Claude-Session: https://claude.ai/code/session_01LSApfKfYxy4VnNUuM1nVBk Signed-off-by: Julius Knorr --- .../euro-office/installation_debian.rst | 17 +++++--- .../euro-office/installation_ubuntu.rst | 17 +++++--- user_manual/office_desktop_editors.rst | 42 ++++++------------- 3 files changed, 36 insertions(+), 40 deletions(-) diff --git a/admin_manual/office/euro-office/installation_debian.rst b/admin_manual/office/euro-office/installation_debian.rst index 3474f4792f2..8eb28f1dd9c 100644 --- a/admin_manual/office/euro-office/installation_debian.rst +++ b/admin_manual/office/euro-office/installation_debian.rst @@ -61,7 +61,11 @@ Step 4 — Pre-seed the installer answers ds ds/db-port string 5432 ds ds/db-user string ds ds ds/db-pwd password ds - ds ds/db-name string ds" | sudo debconf-set-selections + ds ds/db-name string ds + ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | sudo debconf-set-selections + +The last line accepts the license of the Microsoft core fonts, which the Document Server needs to render +documents correctly. Without it, the installer asks for confirmation, and declining leaves the fonts missing. Step 5 — Add the Nextcloud Office repository -------------------------------------------- @@ -78,11 +82,14 @@ Step 6 — Install the package sudo apt-get install -y nextcloud-office-documentserver .. tip:: - For hosts without access to the repository, or to install a specific version, download the - ``.deb`` package from https://download.nextcloud.com/office/docserver/ and install it with - ``sudo apt-get install -y ./.deb``. + To install a specific version, list the available versions and pass one to ``apt-get install``: + + .. code-block:: bash + + apt-cache madison nextcloud-office-documentserver + sudo apt-get install -y nextcloud-office-documentserver= -The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two. +The installer generates fonts, WOPI keys, and JS caches. This can take several minutes. A successful install ends with:: Congratulations, the Nextcloud Office DocumentServer has been installed successfully! diff --git a/admin_manual/office/euro-office/installation_ubuntu.rst b/admin_manual/office/euro-office/installation_ubuntu.rst index e3a5863432c..e22a4e9e8bc 100644 --- a/admin_manual/office/euro-office/installation_ubuntu.rst +++ b/admin_manual/office/euro-office/installation_ubuntu.rst @@ -47,7 +47,11 @@ database connection details so the post-install script can proceed without a pro ds ds/db-port string 5432 ds ds/db-user string ds ds ds/db-pwd password ds - ds ds/db-name string ds" | sudo debconf-set-selections + ds ds/db-name string ds + ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true" | sudo debconf-set-selections + +The last line accepts the license of the Microsoft core fonts, which the Document Server needs to render +documents correctly. Without it, the installer asks for confirmation, and declining leaves the fonts missing. Step 4 — Add the Nextcloud Office repository -------------------------------------------- @@ -64,11 +68,14 @@ Step 5 — Install the package sudo apt-get install -y nextcloud-office-documentserver .. tip:: - For hosts without access to the repository, or to install a specific version, download the - ``.deb`` package from https://download.nextcloud.com/office/docserver/ and install it with - ``sudo apt-get install -y ./.deb``. + To install a specific version, list the available versions and pass one to ``apt-get install``: + + .. code-block:: bash + + apt-cache madison nextcloud-office-documentserver + sudo apt-get install -y nextcloud-office-documentserver= -The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two. +The installer generates fonts, WOPI keys, and JS caches. This can take several minutes. A successful install ends with:: Congratulations, the Nextcloud Office DocumentServer has been installed successfully! diff --git a/user_manual/office_desktop_editors.rst b/user_manual/office_desktop_editors.rst index bbb23e7b17f..3a90fe9b68c 100644 --- a/user_manual/office_desktop_editors.rst +++ b/user_manual/office_desktop_editors.rst @@ -39,6 +39,9 @@ Debian and Ubuntu sudo apt-get install nextcloud-office-nextcloudoffice +The installation also offers the Microsoft core fonts, which improve how documents created in Microsoft Office are +displayed. To install them, accept their license when prompted. + Fedora and RHEL ^^^^^^^^^^^^^^^ @@ -55,35 +58,22 @@ Fedora and RHEL EOF sudo dnf install nextcloud-office-nextcloudoffice -Individual packages -^^^^^^^^^^^^^^^^^^^ +During the first installation, ``dnf`` asks you to confirm the repository signing key. Check that its fingerprint is +``C013 F0BE F968 00BB BC4D 93DD E6E7 0E5F A287 C3D0`` before you accept it. + +Portable archive +^^^^^^^^^^^^^^^^ -If you cannot use the package repository, download a package directly. These packages are not updated -automatically. +On other distributions, use the portable archive. It is not updated automatically. .. list-table:: :header-rows: 1 - * - Distribution - - Architecture + * - Architecture - Download - * - Debian, Ubuntu - - x64 - - `.deb `__ - * - Debian, Ubuntu - - ARM64 - - `.deb `__ - * - Fedora, RHEL, openSUSE - - x64 - - `.rpm `__ - * - Fedora, RHEL, openSUSE - - ARM64 - - `.rpm `__ - * - Any distribution (portable) - - x64 + * - x64 - `.tar.xz `__ - * - Any distribution (portable) - - ARM64 + * - ARM64 - `.tar.xz `__ .. _nco-windows-x64.exe: @@ -92,14 +82,6 @@ automatically. https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-windows-arm64.exe .. _nco-macos-arm64.dmg: https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-macos-arm64.dmg -.. _nco-linux-x64.deb: - https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-x64.deb -.. _nco-linux-arm64.deb: - https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-arm64.deb -.. _nco-linux-x64.rpm: - https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-x64.rpm -.. _nco-linux-arm64.rpm: - https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-arm64.rpm .. _nco-linux-x64.tar.xz: https://download.nextcloud.com/office/desktopeditors/Nextcloud-Office-DesktopEditors-latest-linux-x64.tar.xz .. _nco-linux-arm64.tar.xz: