Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions _shared_assets/_nextcloud_office_apt_repository.rst
Original file line number Diff line number Diff line change
@@ -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
4 changes: 3 additions & 1 deletion admin_manual/contents.rst
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,9 @@ Table of contents
.. toctree::
:caption: Office

office/index
Overview <office/index>
office/euro-office/index
office/collabora_online

.. toctree::
:caption: Collectives
Expand Down
4 changes: 2 additions & 2 deletions admin_manual/office/euro-office/configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://apps.nextcloud.com/apps/eurooffice>`_ from the Nextcloud App Store:

1. Open :menuselection:`Settings --> Apps` in your Nextcloud admin interface.
2. Search for **Euro-Office**.
Expand Down Expand Up @@ -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

Expand Down
3 changes: 2 additions & 1 deletion admin_manual/office/euro-office/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://apps.nextcloud.com/apps/eurooffice>`_.

.. toctree::
:maxdepth: 2
Expand Down
49 changes: 28 additions & 21 deletions admin_manual/office/euro-office/installation_debian.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
-------------------
Expand All @@ -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:

Expand All @@ -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

Expand All @@ -62,30 +61,38 @@ 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

Step 5 — Download the package
------------------------------
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.

Download the latest release from `GitHub Releases <https://github.com/Euro-Office/DocumentServer/releases>`_:
Step 5 — Add the Nextcloud Office repository
--------------------------------------------

.. code-block:: bash
Add the signing key and the package repository so that updates arrive with regular system updates:

# Replace <version> and <arch> with your values, e.g. 9.3.1 and amd64 or arm64
wget "https://github.com/Euro-Office/DocumentServer/releases/download/v<version>/euro-office-documentserver_<version>_<arch>.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::
To install a specific version, list the available versions and pass one to ``apt-get install``:

.. code-block:: bash

The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two.
apt-cache madison nextcloud-office-documentserver
sudo apt-get install -y nextcloud-office-documentserver=<version>

The installer generates fonts, WOPI keys, and JS caches. This can take several minutes.
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
----------------
Expand Down Expand Up @@ -114,19 +121,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<new-version>/euro-office-documentserver_<new-version>_<arch>.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
46 changes: 27 additions & 19 deletions admin_manual/office/euro-office/installation_ubuntu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
-------------------
Expand All @@ -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
Expand Down Expand Up @@ -47,30 +47,38 @@ 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

Step 4 — Download the package
------------------------------
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.

Download the latest release from `GitHub Releases <https://github.com/Euro-Office/DocumentServer/releases>`_:
Step 4 — Add the Nextcloud Office repository
--------------------------------------------

.. code-block:: bash
Add the signing key and the package repository so that updates arrive with regular system updates:

# Replace <version> and <arch> with your values, e.g. 9.3.1 and amd64 or arm64
wget "https://github.com/Euro-Office/DocumentServer/releases/download/v<version>/euro-office-documentserver_<version>_<arch>.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::
To install a specific version, list the available versions and pass one to ``apt-get install``:

.. code-block:: bash

The installer generates fonts, WOPI keys, and JS caches. This takes a minute or two.
apt-cache madison nextcloud-office-documentserver
sudo apt-get install -y nextcloud-office-documentserver=<version>

The installer generates fonts, WOPI keys, and JS caches. This can take several minutes.
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
----------------
Expand Down Expand Up @@ -99,19 +107,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<new-version>/euro-office-documentserver_<new-version>_<arch>.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
11 changes: 2 additions & 9 deletions admin_manual/office/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,23 +4,16 @@ 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
`Nextcloud support subscription <https://nextcloud.com/enterprise/>`_.

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
1 change: 1 addition & 0 deletions user_manual/contents.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Table of contents
talk/index
collectives/index
desktop/index
office_desktop_editors
userpreferences
universal_access
user_2fa
Expand Down
88 changes: 88 additions & 0 deletions user_manual/office_desktop_editors.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
========================
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) <nco-windows-x64.exe_>`__
* - Windows
- ARM64
- `Installer (.exe) <nco-windows-arm64.exe_>`__
* - macOS
- Apple Silicon
- `Disk image (.dmg) <nco-macos-arm64.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

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
^^^^^^^^^^^^^^^

.. 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

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
^^^^^^^^^^^^^^^^

On other distributions, use the portable archive. It is not updated automatically.

.. list-table::
:header-rows: 1

* - Architecture
- Download
* - x64
- `.tar.xz <nco-linux-x64.tar.xz_>`__
* - ARM64
- `.tar.xz <nco-linux-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.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
Loading