Skip to content

docs(office): fix Debian sources, prerequisites and uninstall steps #15921

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
juliusknorr wants to merge 1 commit into
base: docs/nextcloud-office-packages
Choose a base branch
from
+43 −11
Draft

docs(office): fix Debian sources, prerequisites and uninstall steps #15921

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
33 changes: 26 additions & 7 deletions admin_manual/office/euro-office/installation_debian.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,14 +16,19 @@ Step 1 — Enable the contrib component
--------------------------------------

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:
``contrib`` component, which is not enabled by default. Edit ``/etc/apt/sources.list`` and add ``contrib``
after ``main`` on each line. Keep the other components, such as ``non-free-firmware``. On a default installation,
the result looks like this:

.. code-block:: text

deb http://deb.debian.org/debian bookworm main contrib
deb http://deb.debian.org/debian bookworm-updates main contrib
deb http://deb.debian.org/debian-security/ bookworm-security main contrib
deb http://deb.debian.org/debian/ bookworm main contrib non-free-firmware
deb http://security.debian.org/debian-security bookworm-security main contrib non-free-firmware
deb http://deb.debian.org/debian/ bookworm-updates main contrib non-free-firmware

.. note::
Some images, such as Docker and cloud images, use ``/etc/apt/sources.list.d/debian.sources`` instead. In that
case, add ``contrib`` to the ``Components:`` line in that file and leave ``/etc/apt/sources.list`` untouched.

Then update the package index:

Expand All @@ -38,7 +43,7 @@ All prerequisites are available in the default Debian 12 repositories:

.. code-block:: bash

sudo apt-get install -y postgresql redis-server rabbitmq-server nginx supervisor
sudo apt-get install -y postgresql rabbitmq-server nginx

Step 3 — Create the database
-----------------------------
Expand Down Expand Up @@ -77,6 +82,10 @@ Add the signing key and the package repository so that updates arrive with regul
Step 6 — Install the package
-----------------------------

.. warning::
The package configures Nginx to serve the Document Server on port 80 and disables the default site in
``/etc/nginx/sites-enabled``. Install it on a dedicated host, or review your existing Nginx sites first.

.. code-block:: bash

sudo apt-get install -y nextcloud-office-documentserver
Expand Down Expand Up @@ -133,7 +142,17 @@ Uninstalling

.. code-block:: bash

sudo apt-get remove --purge nextcloud-office-documentserver
sudo apt-get remove -y --purge nextcloud-office-documentserver
sudo apt-get autoremove -y
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

Removing the package keeps its configuration, data, and the ``ds`` system user. The configuration contains the
database password, the JWT secret, and the WOPI keys, which a later installation reuses. To remove them as well:

.. code-block:: bash

sudo rm -rf /etc/nextcloud-office /var/www/nextcloud-office /var/lib/nextcloud-office /var/log/nextcloud-office
sudo rm -f /etc/nginx/includes/ds-cache.conf
sudo deluser ds
21 changes: 17 additions & 4 deletions admin_manual/office/euro-office/installation_ubuntu.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,12 @@ System requirements
Step 1 — Install prerequisites
-------------------------------

The Document Server requires PostgreSQL, Redis, RabbitMQ, Nginx, and Supervisor. Install them
before the package:
The Document Server requires PostgreSQL, RabbitMQ, and Nginx. Install them before the package:

.. code-block:: bash

sudo apt-get update
sudo apt-get install -y postgresql redis-server rabbitmq-server nginx supervisor
sudo apt-get install -y postgresql rabbitmq-server nginx

Step 2 — Create the database
-----------------------------
Expand Down Expand Up @@ -63,6 +62,10 @@ Add the signing key and the package repository so that updates arrive with regul
Step 5 — Install the package
-----------------------------

.. warning::
The package configures Nginx to serve the Document Server on port 80 and disables the default site in
``/etc/nginx/sites-enabled``. Install it on a dedicated host, or review your existing Nginx sites first.

.. code-block:: bash

sudo apt-get install -y nextcloud-office-documentserver
Expand Down Expand Up @@ -119,7 +122,17 @@ Uninstalling

.. code-block:: bash

sudo apt-get remove --purge nextcloud-office-documentserver
sudo apt-get remove -y --purge nextcloud-office-documentserver
sudo apt-get autoremove -y
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

Removing the package keeps its configuration, data, and the ``ds`` system user. The configuration contains the
database password, the JWT secret, and the WOPI keys, which a later installation reuses. To remove them as well:

.. code-block:: bash

sudo rm -rf /etc/nextcloud-office /var/www/nextcloud-office /var/lib/nextcloud-office /var/log/nextcloud-office
sudo rm -f /etc/nginx/includes/ds-cache.conf
sudo deluser ds
Loading