From 85932d4cce7c09fd3deb263dfb966286c89d79a0 Mon Sep 17 00:00:00 2001 From: FalkenStein42 <47744227+FalkenStein42@users.noreply.github.com> Date: Fri, 15 Apr 2022 08:20:08 +0200 Subject: [PATCH 01/95] Clarification on permisions for the Redis socket After running into the problem myself and searching online for a solution i think a clarification on how to ensure proper permissions on the redis socket would be helpful to novice administrators --- .../configuration_server/caching_configuration.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/admin_manual/configuration_server/caching_configuration.rst b/admin_manual/configuration_server/caching_configuration.rst index f71703c0b..889c0c000 100644 --- a/admin_manual/configuration_server/caching_configuration.rst +++ b/admin_manual/configuration_server/caching_configuration.rst @@ -85,7 +85,7 @@ You can verify that the Redis daemon is running with ``ps ax``:: ps ax | grep redis 22203 ? Ssl 0:00 /usr/bin/redis-server 127.0.0.1:6379 - + Restart your Web server, add the appropriate entries to your ``config.php``, and refresh your Nextcloud admin page. This example ``config.php`` configuration uses Redis for the distributed server cache:: @@ -124,9 +124,15 @@ to the redis group:: usermod -a -G redis www-data -You might need to restart apache for the changes to take effect:: +And modify the ``unixsocketperm`` of the ``redis.conf`` accordingly:: + + unixsocketperm 770 + +You might need to restart apache and redis for the changes to take effect:: systemctl restart apache2 + systemctl restart redis-server + systemctl restart redis Redis is very configurable; consult `the Redis documentation `_ to learn more. From 71a92062eb876826c1b7f46850dba51307a2a58e Mon Sep 17 00:00:00 2001 From: Florent Poinsaut <1256948+FlorentPoinsaut@users.noreply.github.com> Date: Wed, 12 Jan 2022 08:30:19 +0100 Subject: [PATCH 02/95] Fix traefik v1 example We need to escape $ char in traefik v1 label otherwise this error occurs: `ERROR: Invalid interpolation format for "labels" option in service "web": "https://$1/remote.php/dav/"` Signed-off-by: Florent Poinsaut --- .../configuration_server/reverse_proxy_configuration.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/admin_manual/configuration_server/reverse_proxy_configuration.rst b/admin_manual/configuration_server/reverse_proxy_configuration.rst index 531a9885a..7ed98ebc6 100644 --- a/admin_manual/configuration_server/reverse_proxy_configuration.rst +++ b/admin_manual/configuration_server/reverse_proxy_configuration.rst @@ -74,14 +74,14 @@ Using docker tags: :: traefik.frontend.redirect.permanent: 'true' - traefik.frontend.redirect.regex: https://(.*)/.well-known/(card|cal)dav - traefik.frontend.redirect.replacement: https://$1/remote.php/dav/ + traefik.frontend.redirect.regex: 'https://(.*)/.well-known/(?:card|cal)dav' + traefik.frontend.redirect.replacement: 'https://$$1/remote.php/dav/' Using traefik.toml: :: [frontends.frontend1.redirect] - regex = "https://(.*)/.well-known/(card|cal)dav" + regex = "https://(.*)/.well-known/(?:card|cal)dav" replacement = "https://$1/remote.php/dav/ permanent = true From a141b590b39d57fb98e9953fae36d849ac0a7b9a Mon Sep 17 00:00:00 2001 From: Florent Poinsaut Date: Tue, 14 Jun 2022 09:45:39 +0200 Subject: [PATCH 03/95] Remove trailing slash + add traefik v2 Docker label example + homogeneization of examples Signed-off-by: Florent Poinsaut --- .../reverse_proxy_configuration.rst | 20 ++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/admin_manual/configuration_server/reverse_proxy_configuration.rst b/admin_manual/configuration_server/reverse_proxy_configuration.rst index 7ed98ebc6..e6795d68c 100644 --- a/admin_manual/configuration_server/reverse_proxy_configuration.rst +++ b/admin_manual/configuration_server/reverse_proxy_configuration.rst @@ -70,32 +70,42 @@ Thanks to `@ffried `_ for apache2 example. Traefik 1 ^^^^^^^^^ -Using docker tags: +Using Docker labels: :: traefik.frontend.redirect.permanent: 'true' traefik.frontend.redirect.regex: 'https://(.*)/.well-known/(?:card|cal)dav' - traefik.frontend.redirect.replacement: 'https://$$1/remote.php/dav/' + traefik.frontend.redirect.replacement: 'https://$$1/remote.php/dav' Using traefik.toml: :: [frontends.frontend1.redirect] regex = "https://(.*)/.well-known/(?:card|cal)dav" - replacement = "https://$1/remote.php/dav/ + replacement = "https://$1/remote.php/dav permanent = true Thanks to `@pauvos `_ and `@mrtumnus `_ for traefik examples. Traefik 2 ^^^^^^^^^ + +Using Docker labels: +:: + + traefik.http.routers.nextcloud.middlewares: 'nextcloud_redirectregex' + traefik.http.middlewares.nextcloud_redirectregex.redirectregex.permanent: true + traefik.http.middlewares.nextcloud_redirectregex.redirectregex.regex: 'https://(.*)/.well-known/(?:card|cal)dav' + traefik.http.middlewares.nextcloud_redirectregex.redirectregex.replacement: 'https://$${1}/remote.php/dav' + +Using a TOML file: :: [http.middlewares] [http.middlewares.nextcloud-redirectregex.redirectRegex] permanent = true - regex = "https://(.*)/.well-known/(card|cal)dav" - replacement = "https://${1}/remote.php/dav/" + regex = "https://(.*)/.well-known/(?:card|cal)dav" + replacement = "https://${1}/remote.php/dav" HAProxy ^^^^^^^ From 8066a9469911a5835e0cef3af01aa19bc66e619e Mon Sep 17 00:00:00 2001 From: p-bo Date: Fri, 1 Jul 2022 14:25:28 +0200 Subject: [PATCH 04/95] Correct name for mentioned symbol This symbol (see screenshot below this text in document) is representing link, thus it should be named as chain, not impeller. Signed-off-by: p-bo --- user_manual/groupware/sync_windows10.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/groupware/sync_windows10.rst b/user_manual/groupware/sync_windows10.rst index 51061ee19..74ceb1abe 100644 --- a/user_manual/groupware/sync_windows10.rst +++ b/user_manual/groupware/sync_windows10.rst @@ -24,7 +24,7 @@ Calendar Contacts -------- -1. In the bottom left of the Contacts View (in Nextcloud Contacts) look for a little impeller symbol that looks like this: +1. In the bottom left of the Contacts View (in Nextcloud Contacts) look for a little chain symbol that looks like this: .. image:: ../images/contacts_link.png From 88d39e88c54d2875f1af588838f351b8bcb08e7a Mon Sep 17 00:00:00 2001 From: nbenedek Date: Wed, 6 Jul 2022 19:29:49 +0200 Subject: [PATCH 05/95] reverse proxy: add info about overwrite.cli.url Signed-off-by: Benedek Nagy --- .../configuration_server/reverse_proxy_configuration.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/admin_manual/configuration_server/reverse_proxy_configuration.rst b/admin_manual/configuration_server/reverse_proxy_configuration.rst index c1be32a18..0c45b3ba1 100644 --- a/admin_manual/configuration_server/reverse_proxy_configuration.rst +++ b/admin_manual/configuration_server/reverse_proxy_configuration.rst @@ -51,6 +51,7 @@ or webroot you can use the **overwrite** parameters inside the :file:`config/con * :file:`overwriteprotocol` set the protocol of the proxy. You can choose between the two options **http** and **https**. * :file:`overwritewebroot` set the absolute web path of the proxy to the Nextcloud folder. * :file:`overwritecondaddr` overwrite the values dependent on the remote address. The value must be a **regular expression** of the IP addresses of the proxy. This is useful when you use a reverse SSL proxy only for https access and you want to use the automatic detection for http access. +* :file:`overwrite.cli.url` the base URL for any URLs which are generated within Nextcloud using any kind of command line tools. For example, the value set here will be used by the notifications area. Leave the value empty or omit the parameter to keep the automatic detection. @@ -158,6 +159,7 @@ you can set the following parameters inside the :file:`config/config.php`. 'overwriteprotocol' => 'https', 'overwritewebroot' => '/domain.tld/nextcloud', 'overwritecondaddr' => '^10\.0\.0\.1$', + 'overwrite.cli.url' => 'https://domain.tld/nextcloud', ); .. note:: If you want to use the SSL proxy during installation you have to From df8f3aad7cb8272ee0676412ea6e0bb7cbc8c160 Mon Sep 17 00:00:00 2001 From: Vitor Mattos Date: Mon, 17 Oct 2022 12:48:49 -0300 Subject: [PATCH 06/95] Remove expose email as mandatory Signed-off-by: Vitor Mattos --- .../app_publishing_maintenance/code_signing.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/developer_manual/app_publishing_maintenance/code_signing.rst b/developer_manual/app_publishing_maintenance/code_signing.rst index da6da0a94..f238ded71 100644 --- a/developer_manual/app_publishing_maintenance/code_signing.rst +++ b/developer_manual/app_publishing_maintenance/code_signing.rst @@ -119,11 +119,10 @@ examples will assume that you are trying to sign an application named "contacts". 1. Generate a private key and CSR: ``openssl req -nodes -newkey rsa:4096 -keyout contacts.key -out contacts.csr -subj "/CN=contacts"``. Replace "contacts" with your application identifier. -2. Post the CSR at https://github.com/nextcloud/app-certificate-requests, and configure - your GitHub account to show your mail address in your profile. Nextcloud - might ask you for further information to verify that you're the legitimate - owner of the application. Make sure to keep the private key file (``contacts.key``) - secret and not disclose it to any third parties. +2. Post the CSR at https://github.com/nextcloud/app-certificate-requests, in a + new pull request whith the link of a public repository with the code of your + app. Make sure to keep the private key file (``contacts.key``) secret and + not disclose it to any third parties. 3. Nextcloud will provide you with the signed certificate. 4. Run ``./occ integrity:sign-app`` to sign your application, and specify your private and public keys as well as the path to the application. From 4a1bbfb2e2c04d365101936e3156c595da841ef6 Mon Sep 17 00:00:00 2001 From: Vitor Mattos Date: Mon, 17 Oct 2022 12:50:35 -0300 Subject: [PATCH 07/95] Fix typo Signed-off-by: Vitor Mattos --- developer_manual/app_publishing_maintenance/code_signing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/developer_manual/app_publishing_maintenance/code_signing.rst b/developer_manual/app_publishing_maintenance/code_signing.rst index f238ded71..15bfa430f 100644 --- a/developer_manual/app_publishing_maintenance/code_signing.rst +++ b/developer_manual/app_publishing_maintenance/code_signing.rst @@ -120,7 +120,7 @@ examples will assume that you are trying to sign an application named 1. Generate a private key and CSR: ``openssl req -nodes -newkey rsa:4096 -keyout contacts.key -out contacts.csr -subj "/CN=contacts"``. Replace "contacts" with your application identifier. 2. Post the CSR at https://github.com/nextcloud/app-certificate-requests, in a - new pull request whith the link of a public repository with the code of your + new pull request with the link of a public repository with the code of your app. Make sure to keep the private key file (``contacts.key``) secret and not disclose it to any third parties. 3. Nextcloud will provide you with the signed certificate. From 9501544f3838c9c27f5b44c1e5da8432bf3f9177 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 24 Oct 2022 06:22:31 +0000 Subject: [PATCH 08/95] Bump actions/upload-artifact from 2.2.4 to 3.1.1 Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 2.2.4 to 3.1.1. - [Release notes](https://github.com/actions/upload-artifact/releases) - [Commits](https://github.com/actions/upload-artifact/compare/v2.2.4...v3.1.1) --- updated-dependencies: - dependency-name: actions/upload-artifact dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] --- .github/workflows/sphinxbuild.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/sphinxbuild.yml b/.github/workflows/sphinxbuild.yml index 572b0edb1..d6097c130 100644 --- a/.github/workflows/sphinxbuild.yml +++ b/.github/workflows/sphinxbuild.yml @@ -21,7 +21,7 @@ jobs: shell: bash run: tar czf /tmp/documentation.tar.gz -C user_manual/_build/html . - name: Upload static documentation - uses: actions/upload-artifact@v2.2.4 + uses: actions/upload-artifact@v3.1.1 with: name: User manual.zip path: "/tmp/documentation.tar.gz" @@ -47,7 +47,7 @@ jobs: shell: bash run: tar czf /tmp/documentation.tar.gz -C developer_manual/_build/html/com . - name: Upload static documentation - uses: actions/upload-artifact@v2.2.4 + uses: actions/upload-artifact@v3.1.1 with: name: Developer manual.zip path: "/tmp/documentation.tar.gz" @@ -64,7 +64,7 @@ jobs: shell: bash run: tar czf /tmp/documentation.tar.gz -C admin_manual/_build/html/com . - name: Upload static documentation - uses: actions/upload-artifact@v2.2.4 + uses: actions/upload-artifact@v3.1.1 with: name: Administration manual.zip path: "/tmp/documentation.tar.gz" From dd5e20231482de418fdcb930f61c75169b83deb8 Mon Sep 17 00:00:00 2001 From: Luka Trovic <89908051+luka-nextcloud@users.noreply.github.com> Date: Thu, 10 Nov 2022 20:41:45 +0100 Subject: [PATCH 09/95] docs: add description to disable av background scan Signed-off-by: Luka Trovic <89908051+luka-nextcloud@users.noreply.github.com> --- .../configuration_server/antivirus_configuration.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/admin_manual/configuration_server/antivirus_configuration.rst b/admin_manual/configuration_server/antivirus_configuration.rst index fe1d83483..ecfad69f5 100644 --- a/admin_manual/configuration_server/antivirus_configuration.rst +++ b/admin_manual/configuration_server/antivirus_configuration.rst @@ -168,3 +168,11 @@ Executable When you are satisfied with how ClamAV is operating, you might want to go back and change all of your logging to less verbose levels. + + +Disabling background scan task +----------------- + +You can disable background scan with occ:: + + occ config:app:set files_antivirus av_background_scan --value="off" From 8c47f86d93e7d1ff8f45653582ee6f4ac92c2426 Mon Sep 17 00:00:00 2001 From: Richard Steinmetz Date: Tue, 15 Nov 2022 11:11:42 +0100 Subject: [PATCH 10/95] Improve documentation around Imaginary Ref https://github.com/nextcloud/previewgenerator/issues/323 Ref https://github.com/nextcloud/server/pull/35105 Co-authored-by: Simon L. Signed-off-by: Richard Steinmetz --- admin_manual/installation/server_tuning.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/admin_manual/installation/server_tuning.rst b/admin_manual/installation/server_tuning.rst index c35c151f2..23b9d5bea 100644 --- a/admin_manual/installation/server_tuning.rst +++ b/admin_manual/installation/server_tuning.rst @@ -130,6 +130,9 @@ Previews It is possible to speed up preview generation using an external microservice: `Imaginary `_. +We strongly recommend running our custom docker image that is more up to date than the official image. +You can find the image at `docker.io/nextcloud/aio-imaginary:latest` for x64-architecture. For arm64-architecture, there is the `docker.io/nextcloud/aio-imaginary:latest-arm64` image. + To do so, you will need to deploy the service and make sure that it is not accessible from outside of your servers. Then you can configure Nextcloud to use Imaginary by editing your `config.php`: @@ -147,6 +150,9 @@ Nextcloud to use Imaginary by editing your `config.php`: ], 'preview_imaginary_url' => 'http://', +.. warning:: + + Make sure to start Imaginary with the `-return-size` command line parameter. Otherwise, there will be a minor performance impact. The flag requires a recent version of Imaginary (newer than v1.2.4) and is by default added to the `aio-imaginary` container. .. note:: From cd2beb5625f45c03b4b5b061d84f5aa0d1e5b547 Mon Sep 17 00:00:00 2001 From: p-bo Date: Thu, 17 Nov 2022 21:51:14 +0100 Subject: [PATCH 11/95] fix bugtracker link There can be only one link (two links results in broken link) and also link to server bug tracker is part of linked list of bugtrackers, so shouldn't appear there. Signed-off-by: p-bo --- admin_manual/issues/general_troubleshooting.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index df6650b9f..ed65fe2ee 100644 --- a/admin_manual/issues/general_troubleshooting.rst +++ b/admin_manual/issues/general_troubleshooting.rst @@ -31,8 +31,7 @@ configuration report with the :ref:`occ config command .. _the Nextcloud Forums: https://help.nextcloud.com .. _FAQ page: https://help.nextcloud.com/t/how-to-faq-wiki -.. _bugtracker: https://github.com/nextcloud/server/issues - https://docs.nextcloud.com/server/latest/developer_manual/prologue/bugtracker/index.html +.. _bugtracker: https://docs.nextcloud.com/server/latest/developer_manual/prologue/bugtracker/index.html .. TODO ON RELEASE: Update version number above on release From e59c910f3051b64730ce9f12344d9b318eaf79eb Mon Sep 17 00:00:00 2001 From: p-bo Date: Thu, 17 Nov 2022 22:47:26 +0100 Subject: [PATCH 12/95] Updated link to WebDAV FAQ on OwnCloud forum It seems, that forum was migrated, thus old URL leaded (was redirected) to forum homepage. Fixed by searching new URL of mentioned thread. Signed-off-by: p-bo --- admin_manual/issues/general_troubleshooting.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index df6650b9f..f4330b696 100644 --- a/admin_manual/issues/general_troubleshooting.rst +++ b/admin_manual/issues/general_troubleshooting.rst @@ -223,7 +223,7 @@ See: (Describes problems with Finder on various Web servers) There is also a well maintained FAQ thread available at the `ownCloud Forums -`_ +`_ which contains various additional information about WebDAV problems. .. _service-discovery-label: From d83c5e454f33a3fc056fa218b6c523e44a4447f5 Mon Sep 17 00:00:00 2001 From: p-bo Date: Thu, 17 Nov 2022 22:52:39 +0100 Subject: [PATCH 13/95] Missing comma in sentence Signed-off-by: p-bo --- admin_manual/issues/general_troubleshooting.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index df6650b9f..6a5ea2743 100644 --- a/admin_manual/issues/general_troubleshooting.rst +++ b/admin_manual/issues/general_troubleshooting.rst @@ -255,7 +255,7 @@ module installed to process these redirects. When running Nginx please refer to If your Nextcloud instance is installed in a subfolder called ``nextcloud`` and -you're running Apache create or edit the :file:`.htaccess` file within the +you're running Apache, create or edit the :file:`.htaccess` file within the document root of your Web server and add the following lines:: From 42c6cb2c6e7a1c7bf7313c668e3cf61528a2993a Mon Sep 17 00:00:00 2001 From: p-bo Date: Fri, 18 Nov 2022 14:42:56 +0100 Subject: [PATCH 14/95] lowercase instead of uppercase, colon instead of comma There was combination of comma, followed by uppercase article which is not correct. So replaced upper case article with lowercase one and tried also other variants instead of comma between sentences and colon seems to fit best (but may be only subjective perception). Signed-off-by: p-bo --- admin_manual/maintenance/package_upgrade.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 1bf19fe39..c966f18ae 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -6,7 +6,7 @@ Upgrade quickstart ------------------ One effective, if unofficial method for keeping Nextcloud current on Linux servers is by configuring -your system to use Nextcloud via a self contained "Snap" package, A technology allowing users to +your system to use Nextcloud via a self contained "Snap" package: a technology allowing users to always have the latest version of an "app". That version from Canonical is quite restrictive. It is not aimed at developers or advanced users From cb6727cb9373bcfd107181c2545cd42b37f8ee5c Mon Sep 17 00:00:00 2001 From: p-bo Date: Fri, 18 Nov 2022 15:57:55 +0100 Subject: [PATCH 15/95] tweak to render structured Without it, lines are concatenated and content is thus cluttered. Signed-off-by: p-bo --- admin_manual/maintenance/package_upgrade.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 1bf19fe39..57a0f2919 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -21,12 +21,14 @@ Installation ------------ **Ubuntu** + $ sudo snap install nextcloud **All other distros** -Go to https://docs.snapcraft.io/installing-snapd/6735 -Type the command to install snapd -Install Nextcloud $ sudo snap install nextcloud + +* Go to https://docs.snapcraft.io/installing-snapd/6735 +* Type the command to install snapd +* Install Nextcloud ($ sudo snap install nextcloud) 1st login --------- From b980bbfa4c32488e3133dbc6d1deb674003bbb1a Mon Sep 17 00:00:00 2001 From: p-bo Date: Fri, 18 Nov 2022 16:17:29 +0100 Subject: [PATCH 16/95] Update package_upgrade.rst --- admin_manual/maintenance/package_upgrade.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/admin_manual/maintenance/package_upgrade.rst b/admin_manual/maintenance/package_upgrade.rst index 57a0f2919..63cceb0ac 100644 --- a/admin_manual/maintenance/package_upgrade.rst +++ b/admin_manual/maintenance/package_upgrade.rst @@ -26,6 +26,8 @@ $ sudo snap install nextcloud **All other distros** +(`be warned `_) + * Go to https://docs.snapcraft.io/installing-snapd/6735 * Type the command to install snapd * Install Nextcloud ($ sudo snap install nextcloud) From 1e895576e2ab7ac7f9a59682c5648445fa585bc8 Mon Sep 17 00:00:00 2001 From: p-bo Date: Sat, 19 Nov 2022 20:12:10 +0100 Subject: [PATCH 17/95] Add NextcloudPi to automated install options Because they also provide install script - see Debian tab under Supported Systems section on nextcloudpi.com Signed-off-by: p-bo --- admin_manual/installation/source_installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/installation/source_installation.rst b/admin_manual/installation/source_installation.rst index 1978b1fb3..efd155749 100644 --- a/admin_manual/installation/source_installation.rst +++ b/admin_manual/installation/source_installation.rst @@ -14,7 +14,7 @@ archive `_. This method is recommended to instal If you prefer a more automated installation of Nextcloud and there are no packages for your Linux distribution, you have the option to -install the community `Snap Package `_. This includes a full production-ready stack, will maintain your HTTPS certificates for you, and will automatically update as needed to stay secure. You can also use the `Nextcloud VM scripts `_ to install directly on a clean Ubuntu Server. It will setup everything for you and include scripts for automated installation of apps like; Collabora, OnlyOffice, Talk and so on. Please note that those two options are not officially supported by Nextcloud GmbH. +install the community `Snap Package `_. This includes a full production-ready stack, will maintain your HTTPS certificates for you, and will automatically update as needed to stay secure. You can also use the `Nextcloud VM scripts `_ to install directly on a clean Ubuntu Server or `NextcloudPi scripts `_ (dtto atop Debian). It will setup everything for you and include scripts for automated installation of apps like; Collabora, OnlyOffice, Talk and so on. Please note that those three options are not officially supported by Nextcloud GmbH. This installation guide is giving a general overview of required dependencies and their configuration. For a distribution specific setup guide have a look at the :doc:`./example_ubuntu` and :doc:`./example_centos`. From c3f3363f17cb1b5095ab468b8878c4b8f1461739 Mon Sep 17 00:00:00 2001 From: p-bo Date: Sat, 19 Nov 2022 20:36:55 +0100 Subject: [PATCH 18/95] =?UTF-8?q?Add=20Let=E2=80=99s=20Encrypt=20to=20SSL?= =?UTF-8?q?=20certificates=20tip?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: p-bo --- admin_manual/installation/source_installation.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/admin_manual/installation/source_installation.rst b/admin_manual/installation/source_installation.rst index 1978b1fb3..0500779a2 100644 --- a/admin_manual/installation/source_installation.rst +++ b/admin_manual/installation/source_installation.rst @@ -266,8 +266,8 @@ the default site. Open a terminal and run:: plan to make your Nextcloud server publicly accessible. You might want to consider getting a certificate signed by a commercial signing authority. Check with your domain name registrar or hosting service - for good deals on commercial certificates. - + for good deals on commercial certificates. Or use free `Let's Encrypt `_ one. + .. _installation_wizard_label: Installation wizard From be4b6a4b2cb9ff44329e9d17f18e444695f2ecc2 Mon Sep 17 00:00:00 2001 From: p-bo Date: Sat, 19 Nov 2022 20:51:47 +0100 Subject: [PATCH 19/95] Add NextcloudPi script --- admin_manual/installation/source_installation.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/admin_manual/installation/source_installation.rst b/admin_manual/installation/source_installation.rst index efd155749..28ba9a190 100644 --- a/admin_manual/installation/source_installation.rst +++ b/admin_manual/installation/source_installation.rst @@ -492,12 +492,19 @@ See the `TrueNAS installation documentation `_. 2. Run the script with:: sudo bash nextcloud_install_production.sh + +or + +1. Download the latest `installation script `_. +2. Run the script with:: + + sudo bash install.sh A guided setup will follow and the only thing you have to do it to follow the on screen instructions, when given to you. From b24f71121c5186cfd1abe9c8a6435859810ceab7 Mon Sep 17 00:00:00 2001 From: p-bo Date: Sat, 19 Nov 2022 22:03:12 +0100 Subject: [PATCH 20/95] Removed obsolete note regarding pending backport of NSS into RHEL & derivatives Backport described in linked bug https://bugzilla.redhat.com/show_bug.cgi?id=1241172 was already completed in https://access.redhat.com/errata/RHBA-2016:2335.html Signed-off-by: p-bo --- admin_manual/configuration_server/security_setup_warnings.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/admin_manual/configuration_server/security_setup_warnings.rst b/admin_manual/configuration_server/security_setup_warnings.rst index e09582f37..a624648a9 100644 --- a/admin_manual/configuration_server/security_setup_warnings.rst +++ b/admin_manual/configuration_server/security_setup_warnings.rst @@ -110,9 +110,7 @@ There are known bugs in older OpenSSL and NSS versions leading to misbehavior in combination with remote hosts using SNI. A technology used by most of the HTTPS websites. To ensure that Nextcloud will work properly you need to update OpenSSL to at least 1.0.2b or 1.0.1d. For NSS the patch version depends on your distribution -and an heuristic is running the test which actually reproduces the bug. There -are distributions such as RHEL/CentOS which have this backport still `pending -`_. +and an heuristic is running the test which actually reproduces the bug. Your Web server is not set up properly to resolve /.well-known/caldav/ or /.well-known/carddav/ ----------------------------------------------------------------------------------------------- From a58b35b21f54fefed9f8738c0af01b694f0ce081 Mon Sep 17 00:00:00 2001 From: p-bo Date: Sat, 19 Nov 2022 22:39:32 +0100 Subject: [PATCH 21/95] Point URL to internet archive This site is not existing any more - link updated to point to archived page Signed-off-by: p-bo --- .../configuration_server/config_sample_php_parameters.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index c054d4c8a..91beed0c3 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -1969,7 +1969,7 @@ https://dev.mysql.com/doc/refman/5.7/en/charset-unicode-utf8mb4.html https://dev.mysql.com/doc/refman/5.7/en/innodb-parameters.html#sysvar_innodb_large_prefix https://mariadb.com/kb/en/mariadb/xtradbinnodb-server-system-variables/#innodb_large_prefix http://www.tocker.ca/2013/10/31/benchmarking-innodb-page-compression-performance.html -http://mechanics.flite.com/blog/2014/07/29/using-innodb-large-prefix-to-avoid-error-1071/ +https://web.archive.org/web/20181229154254/http://mechanics.flite.com:80/blog/2014/07/29/using-innodb-large-prefix-to-avoid-error-1071 :: From 6ca0607d6288573dcea2d20e1befe8a325747ebd Mon Sep 17 00:00:00 2001 From: p-bo Date: Sat, 19 Nov 2022 23:02:16 +0100 Subject: [PATCH 22/95] Fix formating - use *italicized text* instead of _italicized text_ , because it was not rendered in used markdown flavour correctly - remove (forgotten?) long line of dashes Signed-off-by: p-bo --- .../configuration_server/config_sample_php_parameters.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index c054d4c8a..5577d6d57 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -809,7 +809,7 @@ The app allows for two settings, a minimum time for trash bin retention, and a maximum time for trash bin retention. Minimum time is the number of days a file will be kept, after which it -_may be_ deleted. A file may be deleted after the minimum number of days +*may be* deleted. A file may be deleted after the minimum number of days is expired if space is needed. The file will not be deleted if space is not needed. @@ -821,8 +821,8 @@ Whether "space is needed" depends on whether a user quota is defined or not: * If a user quota is defined, 50% of the user's remaining quota space sets the limit for the trashbin. -Maximum time is the number of days at which it is _guaranteed -to be_ deleted. There is no further dependency on the available space. +Maximum time is the number of days at which it is *guaranteed +to be* deleted. There is no further dependency on the available space. Both minimum and maximum times can be set together to explicitly define file and folder deletion. For migration purposes, this setting is installed @@ -2049,7 +2049,7 @@ of your php version. Then set the setting to true. Nextcloud uses the Argon2 algorithm (with PHP >= 7.2) to create hashes by its own and exposes its configuration options as following. More information can be found at: https://www.php.net/manual/en/function.password-hash.php --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- + :: From a57194cf8f47c1a826e95c8bd8347de1da0bce9f Mon Sep 17 00:00:00 2001 From: p-bo Date: Sun, 20 Nov 2022 00:02:26 +0100 Subject: [PATCH 23/95] future-proof link to desktop client docs latest instead version number to stay functional/current Signed-off-by: p-bo --- .../configuration_files/big_file_upload_configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_files/big_file_upload_configuration.rst b/admin_manual/configuration_files/big_file_upload_configuration.rst index 61ce2e937..861d0ebfa 100644 --- a/admin_manual/configuration_files/big_file_upload_configuration.rst +++ b/admin_manual/configuration_files/big_file_upload_configuration.rst @@ -14,7 +14,7 @@ hard limits that cannot be exceeded: filesystem. .. note:: The Nextcloud sync client is not affected by these upload limits - as it is uploading files in smaller chunks. See `Client documentation `_ + as it is uploading files in smaller chunks. See `Client documentation `_ for more information on configuration options. System configuration From d26c4b86982c60b041ba3c2fc29143e98cdfb639 Mon Sep 17 00:00:00 2001 From: p-bo Date: Sun, 20 Nov 2022 00:27:51 +0100 Subject: [PATCH 24/95] Remove link to disappeared document This URL is no longer functional and cannot by found in internet archive :-( Signed-off-by: p-bo --- admin_manual/configuration_files/encryption_details.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/admin_manual/configuration_files/encryption_details.rst b/admin_manual/configuration_files/encryption_details.rst index b47c0e86f..267cc4b34 100644 --- a/admin_manual/configuration_files/encryption_details.rst +++ b/admin_manual/configuration_files/encryption_details.rst @@ -348,7 +348,6 @@ Sources - `nextcloud-tools repository on GitHub `_ - `Nextcloud Encryption Configuration documentation `_ - `Nextcloud Help response concering the usage of version information `_ -- `Overview of ownCloud Encryption Model `_ - `Sourcecode: Creation of the Message Authentication Code `_ - `Sourcecode: Derivation of the Encryption Key `_ - `Sourcecode: Encryption of the File `_ From 98759e6e13bc1029c05f3517def101a4a011f9fe Mon Sep 17 00:00:00 2001 From: Robin Windey Date: Mon, 21 Nov 2022 06:20:01 +0000 Subject: [PATCH 25/95] Add DevContainer for GitHub Codespaces Signed-off-by: GitHub --- .devcontainer/Dockerfile | 15 +++++++++++++++ .devcontainer/devcontainer.json | 16 ++++++++++++++++ README.rst | 10 ++++++++++ 3 files changed, 41 insertions(+) create mode 100644 .devcontainer/Dockerfile create mode 100644 .devcontainer/devcontainer.json diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile new file mode 100644 index 000000000..2f9a9a555 --- /dev/null +++ b/.devcontainer/Dockerfile @@ -0,0 +1,15 @@ +FROM python:3.9 as final + +USER root + +# Add dev tools needed for building +RUN export DEBIAN_FRONTEND=noninteractive \ + && apt-get update \ + && apt-get -y install --no-install-recommends \ + curl gnupg2 git nano make graphviz imagemagick inkscape sass unzip wget php-cli npm latexmk texlive-latex-extra tex-gyre \ + && wget https://getcomposer.org/installer -qO /tmp/composer-setup.php \ + && php /tmp/composer-setup.php \ + && mv composer.phar /usr/local/bin/composer \ + && npm install svgexport -g \ + && rm -f /tmp/composer-setup.php \ + && rm -rf /var/lib/apt/lists/* \ No newline at end of file diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json new file mode 100644 index 000000000..ad5d0211a --- /dev/null +++ b/.devcontainer/devcontainer.json @@ -0,0 +1,16 @@ +// For format details, see https://aka.ms/devcontainer.json. +{ + "name": "Nextcloud documentation DevContainer", + "context": "..", + "dockerFile": "Dockerfile", + "containerUser": "root", + "customizations": { + "vscode": { + "extensions": [ + "tht13.rst-vscode", + "tomoki1207.pdf" + ] + } + }, + "postCreateCommand": "python3 -m pip install -r requirements.txt && python3 -m pip install sphinx-autobuild && cd build && composer install --ignore-platform-reqs" +} diff --git a/README.rst b/README.rst index 1ea0e71fb..82dfe872c 100644 --- a/README.rst +++ b/README.rst @@ -134,6 +134,16 @@ Building PDF 5. Install the dependencies `pip install -r requirements.txt` 6. Now you can use `make ...` to build all the stuff - for example `make pdf` to build the PDF flavor of all manuals +Using the VSCode DevContainer +============================= + +This repository contains a full-featured `VSCode DevContainer `_. +You can use it in your local development environment or via `GitHub Codespaces `_. +Just open the container an use one of the commands from above to build the project. For example ``make`` to build the full +documentaion, ``make html`` to build the HTML documentaion or ``make pdf`` to build the PDF documentation. You can also use +``make SPHINXBUILD=sphinx-autobuild html`` in combination with `port forwarding `_ +to watch file changes and automatically reload the html preview. + Icons ----- From 0c9feba9268a8430c125592ca76da94151d90a3d Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Mon, 21 Nov 2022 20:10:54 +0000 Subject: [PATCH 26/95] Apply translations in ca translation completed for the source file '/user_manual/locale/source/sphinx.pot' on the 'ca' language. --- user_manual/locale/ca/LC_MESSAGES/sphinx.po | 42 +++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 user_manual/locale/ca/LC_MESSAGES/sphinx.po diff --git a/user_manual/locale/ca/LC_MESSAGES/sphinx.po b/user_manual/locale/ca/LC_MESSAGES/sphinx.po new file mode 100644 index 000000000..4ebd5f002 --- /dev/null +++ b/user_manual/locale/ca/LC_MESSAGES/sphinx.po @@ -0,0 +1,42 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022 Nextcloud GmbH +# This file is distributed under the same license as the Nextcloud latest User Manual package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Eloitor, 2022 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Nextcloud latest User Manual latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-01-07 14:47+0100\n" +"PO-Revision-Date: 2020-07-31 12:17+0000\n" +"Last-Translator: Eloitor, 2022\n" +"Language-Team: Catalan (https://www.transifex.com/nextcloud/teams/64236/ca/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ca\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: ../../_templates/versions.html:17 +msgid "Versions" +msgstr "Versions" + +#: ../../_templates/versions.html:23 +msgid "Downloads" +msgstr "Descàrregues" + +#: ../../_templates/versions.html:30 +msgid "On Read the Docs" +msgstr "Sobre la documentació" + +#: ../../_templates/versions.html:32 +msgid "Project Home" +msgstr "Pàgina principal del projecte" + +#: ../../_templates/versions.html:35 +msgid "Builds" +msgstr "Versions compilades" From 823ff34d07be6db2a775ea484c8e64a3dad4d9cf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6?= Date: Tue, 22 Nov 2022 09:00:11 +0100 Subject: [PATCH 27/95] Fix browsers requirements MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: John Molakvoæ --- user_manual/webinterface.rst | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/user_manual/webinterface.rst b/user_manual/webinterface.rst index 3a4fbd147..7b4e6cf82 100644 --- a/user_manual/webinterface.rst +++ b/user_manual/webinterface.rst @@ -11,31 +11,29 @@ your Nextcloud server URL (e.g. cloud.example.com) and enter your username and p Web browser requirements ------------------------ -For the best experience with the Nextcloud web interface, we recommend that you use the -latest and supported version of a browser from this list: - +For the best experience with the Nextcloud web interface, we recommend that +you use the latest and supported version of a browser from this list: .. No need to translate - -* Google **Chrome**/Chromium +* Google **Chrome**/Chromium (Desktop and Android) .. No need to translate - -* Mozilla **Firefox** +* Mozilla **Firefox** (Desktop and Android) .. No need to translate - -* Apple **Safari** +* Apple **Safari** (Desktop and iOS) .. No need to translate - * Microsoft **Edge** +.. note:: Not all versions are supported. Nextcloud is tested and built to work with `these versions only. + ` + .. note:: If you want to use Nextcloud Talk you need to run Mozilla **Firefox** 52+ or Google **Chrome**/Chromium 49+ to have the full experience with video calls and - screensharing. Google **Chrome**/Chromium requires a additional plugin for screensharing. + screensharing. -.. note:: Microsoft **Internet Explorer** is **NOT** supported. +.. warning:: Microsoft **Internet Explorer** is **NOT** supported. Navigating the main user interface ---------------------------------- From 0c8908907e0e2464ae8ef3613d0b9cdfbe8193e5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6?= Date: Tue, 22 Nov 2022 09:16:35 +0100 Subject: [PATCH 28/95] Fix link syntax MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Joas Schilling <213943+nickvergessen@users.noreply.github.com> Signed-off-by: John Molakvoæ --- user_manual/webinterface.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/webinterface.rst b/user_manual/webinterface.rst index 7b4e6cf82..99830ae44 100644 --- a/user_manual/webinterface.rst +++ b/user_manual/webinterface.rst @@ -27,7 +27,7 @@ you use the latest and supported version of a browser from this list: * Microsoft **Edge** .. note:: Not all versions are supported. Nextcloud is tested and built to work with `these versions only. - ` + `_ .. note:: If you want to use Nextcloud Talk you need to run Mozilla **Firefox** 52+ or Google **Chrome**/Chromium 49+ to have the full experience with video calls and From 22a8276329d821d9f1d771edca46e83c8e1c130a Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Tue, 22 Nov 2022 11:05:20 +0100 Subject: [PATCH 29/95] Fix linting things Signed-off-by: Joas Schilling --- user_manual/webinterface.rst | 17 +++++------------ 1 file changed, 5 insertions(+), 12 deletions(-) diff --git a/user_manual/webinterface.rst b/user_manual/webinterface.rst index 99830ae44..62783e1f0 100644 --- a/user_manual/webinterface.rst +++ b/user_manual/webinterface.rst @@ -14,25 +14,18 @@ Web browser requirements For the best experience with the Nextcloud web interface, we recommend that you use the latest and supported version of a browser from this list: -.. No need to translate * Google **Chrome**/Chromium (Desktop and Android) - -.. No need to translate * Mozilla **Firefox** (Desktop and Android) - -.. No need to translate * Apple **Safari** (Desktop and iOS) - -.. No need to translate * Microsoft **Edge** .. note:: Not all versions are supported. Nextcloud is tested and built to work with `these versions only. `_ .. note:: If you want to use Nextcloud Talk you need to run Mozilla **Firefox** 52+ - or Google **Chrome**/Chromium 49+ to have the full experience with video calls and + or Google **Chrome**/Chromium 49+ to have the full experience with video calls and screensharing. - + .. warning:: Microsoft **Internet Explorer** is **NOT** supported. Navigating the main user interface @@ -43,7 +36,7 @@ By default, the Nextcloud Web interface opens to your Dashboard or Files page: .. figure:: images/files_page.png :scale: 75% :alt: The main Files view. - + In Files you can add, remove, and share files, and the server administrator can change access privileges. @@ -70,9 +63,9 @@ The Nextcloud user interface contains the following fields and functions: enables you to create new files, new folders, or upload files. .. note:: You can also drag and drop files from your file manager into the - Files Application View to upload them to your instance. + Files Application View to upload them to your instance. -* **Search** field (6): Click on the Magnifier in the upper right corner +* **Search** field (6): Click on the Magnifier in the upper right corner to search for files and entries of the current app. * **Contacts Menu** (7): Gives you an overview about your contacts and users on From 7808d8fb74a5646a8a5589d6db1c62bb05b42c60 Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Tue, 22 Nov 2022 14:41:41 +0000 Subject: [PATCH 30/95] Apply translations in el translation completed for the source file '/user_manual/locale/source/external_storage/external_storage.pot' on the 'el' language. --- .../external_storage/external_storage.po | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 user_manual/locale/el/LC_MESSAGES/external_storage/external_storage.po diff --git a/user_manual/locale/el/LC_MESSAGES/external_storage/external_storage.po b/user_manual/locale/el/LC_MESSAGES/external_storage/external_storage.po new file mode 100644 index 000000000..04f5cb7c3 --- /dev/null +++ b/user_manual/locale/el/LC_MESSAGES/external_storage/external_storage.po @@ -0,0 +1,45 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022 Nextcloud GmbH +# This file is distributed under the same license as the Nextcloud latest User Manual package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Georgia Konstantiou, 2022 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Nextcloud latest User Manual latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-06-03 12:01+0000\n" +"PO-Revision-Date: 2019-11-07 20:28+0000\n" +"Last-Translator: Georgia Konstantiou, 2022\n" +"Language-Team: Greek (https://www.transifex.com/nextcloud/teams/64236/el/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: el\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: ../../external_storage/external_storage.rst:3 +msgid "Configuring External Storage" +msgstr "Διαμόρφωση εξωτερικού χώρου αποθήκευσης" + +#: ../../external_storage/external_storage.rst:5 +msgid "" +"The External Storage application allows you to mount external storage " +"services, such as Amazon S3, SMB/CIFS file servers and FTP servers… in " +"Nextcloud. Your Nextcloud server administrator controls which of these are " +"available to you. Please see `Configuring External Storage (GUI) " +"`_" +" in the Nextcloud Administrator's manual for configuration how-tos and " +"examples." +msgstr "" +"Η εφαρμογή Εξωτερικός χώρος αποθήκευσης σάς επιτρέπει να προσαρτήσετε " +"εξωτερικές υπηρεσίες αποθήκευσης, όπως Amazon S3, διακομιστές αρχείων SMB / " +"CIFS και διακομιστές FTP ... στο Nextcloud. Ο διαχειριστής του διακομιστή " +"Nextcloud ελέγχει ποια από αυτά είναι διαθέσιμα σε εσάς. Παρακαλώ ανατρέξτε " +"στη Διαμόρφωση εξωτερικού χώρου αποθήκευσης (GUI) " +"\"" +" _ στο εγχειρίδιο του Nextcloud Administrator για ρυθμίσεις παραμέτρων και " +"παραδείγματα." From eaf514cd600aa5662ff3326db3f046fd82de91ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julius=20H=C3=A4rtl?= Date: Tue, 22 Nov 2022 18:13:14 +0100 Subject: [PATCH 31/95] Adapt session handling description to changes in Nextcloud 25 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Julius Härtl --- developer_manual/basics/controllers.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/developer_manual/basics/controllers.rst b/developer_manual/basics/controllers.rst index e3a8bda09..0eb47c1b7 100644 --- a/developer_manual/basics/controllers.rst +++ b/developer_manual/basics/controllers.rst @@ -220,6 +220,14 @@ Reading and writing session variables To set, get or modify session variables, the ISession object has to be injected into the controller. +Nextcloud will read existing session data at the beginning of the request lifecycle and close the session afterwards. This means that in order to write to the session, the session has to be opened first. This is done implicitly when calling the set method, but would close immidiately afterwards. To prevent this, the session has to be explicitly opened by calling the reopen method. + +Alternatively you can use the UseSession annotation to automatically open and close the session for you. + +In case the session may be read and written by concurrent requests of your application keeping the session open during your controller method execution may be required to ensure that the session is locked and no other request can write to the session at the same time. When reopening the session, the session data will also get updated with the latest changes from other requests. Using the annotation will keep the session lock during the whole time of the controller method execution. + +For additional information on how session locking works in PHP see the artile about `PHP Session Locking: How To Prevent Sessions Blocking in PHP requests `_. + Then session variables can be accessed like this: .. note:: The session is closed automatically for writing, unless you add the @UseSession annotation! From dad30bbc740f500280ed184abe32c94d2a16b877 Mon Sep 17 00:00:00 2001 From: "transifex-integration[bot]" <43880903+transifex-integration[bot]@users.noreply.github.com> Date: Wed, 23 Nov 2022 15:39:14 +0000 Subject: [PATCH 32/95] Apply translations in ca translation completed for the source file '/user_manual/locale/source/webinterface.pot' on the 'ca' language. --- .../locale/ca/LC_MESSAGES/webinterface.po | 266 ++++++++++++++++++ 1 file changed, 266 insertions(+) create mode 100644 user_manual/locale/ca/LC_MESSAGES/webinterface.po diff --git a/user_manual/locale/ca/LC_MESSAGES/webinterface.po b/user_manual/locale/ca/LC_MESSAGES/webinterface.po new file mode 100644 index 000000000..51c2f0129 --- /dev/null +++ b/user_manual/locale/ca/LC_MESSAGES/webinterface.po @@ -0,0 +1,266 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2022 Nextcloud GmbH +# This file is distributed under the same license as the Nextcloud latest User Manual package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# oriol90 , 2020 +# David Jacovkis , 2020 +# omar.maciasmolina , 2022 +# v v , 2022 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Nextcloud latest User Manual latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2022-06-03 12:01+0000\n" +"PO-Revision-Date: 2019-11-07 20:28+0000\n" +"Last-Translator: v v , 2022\n" +"Language-Team: Catalan (https://www.transifex.com/nextcloud/teams/64236/ca/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: ca\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +#: ../../webinterface.rst:3 +msgid "The Nextcloud Web interface" +msgstr "La interfície web de Nextcloud" + +#: ../../webinterface.rst:5 +msgid "" +"You can connect to your Nextcloud server using any Web browser. Just point " +"it to your Nextcloud server URL (e.g. cloud.example.com) and enter your " +"username and password:" +msgstr "" +"Pots connectar-te al teu servidor Nextcloud mitjançant qualsevol navegador " +"web. Apunteu-ho a la vostra URL del servidor Nextcloud (p. ex. " +"núvol.example.com) i introduïu el vostre nom d'usuari i contrasenya:" + +#: ../../webinterface.rst:12 +msgid "Web browser requirements" +msgstr "Requeriments del navegador web" + +#: ../../webinterface.rst:14 +msgid "" +"For the best experience with the Nextcloud web interface, we recommend that " +"you use the latest and supported version of a browser from this list:" +msgstr "" +"Per tindre la millor experiència possible amb la interfície web de " +"Nextcloud, recomanem que feu servir la versió més recent suportada d'un dels" +" navegadors d'aquesta llista:" + +#: ../../webinterface.rst:20 +msgid "Google **Chrome**/Chromium" +msgstr "Google **Chrome**/Chromium" + +#: ../../webinterface.rst:24 +msgid "Mozilla **Firefox**" +msgstr "Mozilla **Firefox**" + +#: ../../webinterface.rst:28 +msgid "Apple **Safari**" +msgstr "Apple **Safari**" + +#: ../../webinterface.rst:32 +msgid "Microsoft **Edge**" +msgstr "Microsoft **Edge**" + +#: ../../webinterface.rst:34 +msgid "" +"If you want to use Nextcloud Talk you need to run Mozilla **Firefox** 52+ or" +" Google **Chrome**/Chromium 49+ to have the full experience with video calls" +" and screensharing. Google **Chrome**/Chromium requires a additional plugin " +"for screensharing." +msgstr "" +"Si voleu fer servir Nextcloud Talk heu de fer servir Mozilla **Firefox** " +"52+ o Google **Chrome**/Chromium 49+ per gaudir de l'experiència completa " +"amb trucades de vídeo i pantalla compartida. Google **Chrome**/Chromium " +"requereix una extensió addicional per compartir pantalla. " + +#: ../../webinterface.rst:38 +msgid "Microsoft **Internet Explorer** is **NOT** supported." +msgstr "**Internet Explorer** de Microsoft **NO** està suportat." + +#: ../../webinterface.rst:41 +msgid "Navigating the main user interface" +msgstr "Explorant la interfície principal d'usuari" + +#: ../../webinterface.rst:43 +msgid "" +"By default, the Nextcloud Web interface opens to your Dashboard or Files " +"page:" +msgstr "" +"Per defecte, la interfície web de Nextcloud s'obre a la vostra pàgina " +"Dashboard o Fitxers:" + +#: ../../webinterface.rst:49 +msgid "" +"In Files you can add, remove, and share files, and the server administrator " +"can change access privileges." +msgstr "" +"A Fitxers podeu afegir, eliminar i compartir fitxers, i l'administrador del " +"servidor pot canviar els privilegis d'accés." + +#: ../../webinterface.rst:52 +msgid "" +"The Nextcloud user interface contains the following fields and functions:" +msgstr "" +"La interfície d'usuari de Nextcloud conté els següents camps i funcions:" + +#: ../../webinterface.rst:54 +msgid "" +"**Apps Selection Menu** (1): Located in the upper left corner, you'll find " +"all your apps which are available on your instance of Nextcloud. Clicking on" +" an app icon will redirect you to the app." +msgstr "" +"**Menú de selecció d'aplicacions** (1): situat a la cantonada superior " +"esquerra, trobareu totes les vostres aplicacions disponibles a la vostra " +"instància de Nextcloud. Si feu clic a la icona d'una aplicació, us " +"redirigirà a l'aplicació." + +#: ../../webinterface.rst:58 +msgid "" +"**Apps Information** field (2): Located in the left sidebar, this provides " +"filters and tasks associated with your selected app. For example, when you " +"are using the Files app you have a special set of filters for quickly " +"finding your files, such as files that have been shared with you, and files " +"that you have shared with others. You'll see different items for other apps." +msgstr "" +"Camp **Informació de l'aplicació** (2): situat a la barra lateral esquerra, " +"proporciona filtres i tasques associades a l'aplicació seleccionada. Per " +"exemple, quan utilitzeu l'aplicació Fitxers, teniu un conjunt especial de " +"filtres per trobar ràpidament els vostres fitxers, com ara fitxers que s'han" +" compartit amb vosaltres i fitxers que heu compartit amb altres persones. " +"Veureu diferents elements per a altres aplicacions." + +#: ../../webinterface.rst:64 +msgid "" +"**Application View** (3): The main central field in the Nextcloud user " +"interface. This field displays the contents or user features of your " +"selected app." +msgstr "" +"** Vista d'Aplicació** (3): El camp principal al centre de la interfície " +"d'usuari de Nextcloud. Aquest camp mostra els continguts o funcionalitats de" +" l'aplicació seleccionada." + +#: ../../webinterface.rst:67 +msgid "" +"**Navigation Bar** (4): Located over the main viewing window (the " +"Application View), this bar provides a type of breadcrumbs navigation that " +"enables you to migrate to higher levels of the folder hierarchy up to the " +"root level (home)." +msgstr "" +"**Barra de Navegació** (4): Situada sobre la vista principal (la Vista " +"d'Aplicació), aquesta barra proporciona una mena de navegació per fil " +"d'Ariadna que us permet ascendir a nivells superiors de la jerarquia de " +"carpetes fins arribar al nivell arrel (carpeta de l'usuari)" + +#: ../../webinterface.rst:71 +msgid "" +"**New** button (5): Located in the Navigation Bar, the ``New`` button " +"enables you to create new files, new folders, or upload files." +msgstr "" +"Botó **Nou** (5): Situat a la Barra de Navegació, el botó ``Nou`` us permet " +"crear nous arxius, noves carpetes, o pujar arxius." + +#: ../../webinterface.rst:74 +msgid "" +"You can also drag and drop files from your file manager into the Files " +"Application View to upload them to your instance." +msgstr "" +"També podeu arrossegar i deixar anar fitxers des del vostre gestor de " +"fitxers a la Vista d'aplicacions de fitxers per carregar-los a la vostra " +"instància." + +#: ../../webinterface.rst:77 +msgid "" +"**Search** field (6): Click on the Magnifier in the upper right corner to " +"search for files and entries of the current app." +msgstr "" +"Camp *Cerca** (6): Feu clic al Magnificador a la cantonada superior dreta " +"per cercar fitxers i entrades de l'aplicació actual." + +#: ../../webinterface.rst:80 +msgid "" +"**Contacts Menu** (7): Gives you an overview about your contacts and users " +"on your server. Dependent on the given details and available apps, you can " +"directly start a video call with them or send emails." +msgstr "" +"**Menú de Contactes** (7): Us ofereix una vista general dels vostres " +"contactes i d'altres usuaris del vostre servidor. Depenent dels detalls " +"proporcionats i de les aplicacions disponibles, podeu començar directament " +"una trucada de vídeo amb ells o enviar-los emails." + +#: ../../webinterface.rst:84 +msgid "" +"**Grid view** button (8): This looks like four little squares, which toggles" +" the grid view for folders and files." +msgstr "" +"Botó *Vista de graella* (8): Això sembla quatre quadrats petits, que commuta" +" la vista de graella per a carpetes i fitxers." + +#: ../../webinterface.rst:87 +msgid "" +"**Settings** menu (9): Click on your profile picture, located to the right " +"of the Search field, to open your Settings dropdown menu. Your Settings page" +" provides the following settings and features:" +msgstr "" +"Menú de **Configuració** (9): Feu clic a la vostra imatge de perfil, situada" +" a la dreta del camp de Cerca, per obrir el menú desplegable de " +"Configuració. La vostra pàgina de Configuració proporciona les següents " +"opcions i funcionalitats:" + +#: ../../webinterface.rst:91 +msgid "Links to download desktop and mobile apps" +msgstr "" +"Enllaços a descàrregues d'aplicacions per escriptori i dispositius mòbils" + +#: ../../webinterface.rst:92 +msgid "Server usage and space availability" +msgstr "Ús del servidor i disponibilitat d'espai" + +#: ../../webinterface.rst:93 +msgid "Password management" +msgstr "Gestió de contrasenyes" + +#: ../../webinterface.rst:94 +msgid "Name, email, and profile picture settings" +msgstr "Configuració de nom, correu electrònic, i imatge de perfil" + +#: ../../webinterface.rst:95 +msgid "Manage connected browsers and devices" +msgstr "Gestioneu navegadors i dispositius connectats" + +#: ../../webinterface.rst:96 +msgid "Group memberships" +msgstr "Pertinença a grups" + +#: ../../webinterface.rst:97 +msgid "Interface language settings" +msgstr "Configuració d'idiomes de la interfície" + +#: ../../webinterface.rst:98 +msgid "Manage notifications" +msgstr "Gestioneu les notificacions" + +#: ../../webinterface.rst:99 +msgid "Federated Cloud ID and social media-sharing buttons" +msgstr "Botons de Federated Cloud ID i compartició a xarxes socials" + +#: ../../webinterface.rst:100 +msgid "SSL/TLS certificate manager for external storages" +msgstr "Gestor de certificats SSL/TLS per a emmagatzematges externs" + +#: ../../webinterface.rst:101 +msgid "Your Two-factor Settings" +msgstr "La vostra configuració d'autenticació de dos factors" + +#: ../../webinterface.rst:102 +msgid "Nextcloud Version information" +msgstr "Informació de la Versió de Nextcloud" + +#: ../../webinterface.rst:104 +msgid "See :doc:`userpreferences` section to learn more about these settings." +msgstr "Veieu :doc:`userpreferences` per aprendre més sobre aquestes opcions" From 1f7f6b2a50b6de0b8d53b6bcc8b24e62a7002bda Mon Sep 17 00:00:00 2001 From: Nextcloud bot Date: Sat, 26 Nov 2022 03:36:33 +0000 Subject: [PATCH 33/95] generate documentation from config.sample.php --- .../configuration_server/config_sample_php_parameters.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 5577d6d57..c054d4c8a 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -809,7 +809,7 @@ The app allows for two settings, a minimum time for trash bin retention, and a maximum time for trash bin retention. Minimum time is the number of days a file will be kept, after which it -*may be* deleted. A file may be deleted after the minimum number of days +_may be_ deleted. A file may be deleted after the minimum number of days is expired if space is needed. The file will not be deleted if space is not needed. @@ -821,8 +821,8 @@ Whether "space is needed" depends on whether a user quota is defined or not: * If a user quota is defined, 50% of the user's remaining quota space sets the limit for the trashbin. -Maximum time is the number of days at which it is *guaranteed -to be* deleted. There is no further dependency on the available space. +Maximum time is the number of days at which it is _guaranteed +to be_ deleted. There is no further dependency on the available space. Both minimum and maximum times can be set together to explicitly define file and folder deletion. For migration purposes, this setting is installed @@ -2049,7 +2049,7 @@ of your php version. Then set the setting to true. Nextcloud uses the Argon2 algorithm (with PHP >= 7.2) to create hashes by its own and exposes its configuration options as following. More information can be found at: https://www.php.net/manual/en/function.password-hash.php - +-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- :: From d17ea611a4849208e6e0ceefa91b1e6cbb143dd7 Mon Sep 17 00:00:00 2001 From: Luka Trovic <89908051+luka-nextcloud@users.noreply.github.com> Date: Mon, 28 Nov 2022 08:04:25 +0100 Subject: [PATCH 34/95] feat: update description MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Julius Härtl Signed-off-by: Luka Trovic <89908051+luka-nextcloud@users.noreply.github.com> --- admin_manual/configuration_server/antivirus_configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/antivirus_configuration.rst b/admin_manual/configuration_server/antivirus_configuration.rst index ecfad69f5..d039f6e2f 100644 --- a/admin_manual/configuration_server/antivirus_configuration.rst +++ b/admin_manual/configuration_server/antivirus_configuration.rst @@ -171,7 +171,7 @@ back and change all of your logging to less verbose levels. Disabling background scan task ------------------ +------------------------------ You can disable background scan with occ:: From 09664f83ed88e44d9a66b4860a15511269856c39 Mon Sep 17 00:00:00 2001 From: Luka Trovic <89908051+luka-nextcloud@users.noreply.github.com> Date: Mon, 28 Nov 2022 08:04:39 +0100 Subject: [PATCH 35/95] feat: update description MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Julius Härtl Signed-off-by: Luka Trovic <89908051+luka-nextcloud@users.noreply.github.com> --- admin_manual/configuration_server/antivirus_configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/admin_manual/configuration_server/antivirus_configuration.rst b/admin_manual/configuration_server/antivirus_configuration.rst index d039f6e2f..68145f165 100644 --- a/admin_manual/configuration_server/antivirus_configuration.rst +++ b/admin_manual/configuration_server/antivirus_configuration.rst @@ -173,6 +173,6 @@ back and change all of your logging to less verbose levels. Disabling background scan task ------------------------------ -You can disable background scan with occ:: +You can disable background scan with occ to only scan files during upload. occ config:app:set files_antivirus av_background_scan --value="off" From 6034de3149fb1ac74d9eb22bbb5da4a29a6cb35f Mon Sep 17 00:00:00 2001 From: Vincent Petry Date: Mon, 28 Nov 2022 22:05:05 +0100 Subject: [PATCH 36/95] Update instructions for upgrading from ownCloud 10.11 Signed-off-by: Vincent Petry --- admin_manual/maintenance/manual_upgrade.rst | 15 +++++++++------ .../maintenance/migrating_owncloud.rst | 18 +++++++----------- 2 files changed, 16 insertions(+), 17 deletions(-) diff --git a/admin_manual/maintenance/manual_upgrade.rst b/admin_manual/maintenance/manual_upgrade.rst index 86d5b4871..985db124f 100644 --- a/admin_manual/maintenance/manual_upgrade.rst +++ b/admin_manual/maintenance/manual_upgrade.rst @@ -48,31 +48,34 @@ Always start by making a fresh backup and disabling all 3rd party apps. backed-up/old ``nextcloud/apps/`` folder. If you find 3rd party apps in the old folder that needs to be in the new/upgraded instance, simply copy them over and ensure the permissions are set up as shown below. + +10. If you have additional apps folders like for example ``nextcloud/apps-extras`` or ``nextcloud/apps-external``, + make sure to also transfer/keep these in the upgraded folder. -10. If you are using 3rd party theme make sure to copy it from your ``themes/`` +11. If you are using 3rd party theme make sure to copy it from your ``themes/`` directory to your new one. It is possible you will have to make some modifications to it after the upgrade. -11. Adjust file ownership and permissions:: +12. Adjust file ownership and permissions:: chown -R www-data:www-data nextcloud find nextcloud/ -type d -exec chmod 750 {} \; find nextcloud/ -type f -exec chmod 640 {} \; -12. Restart your Web server. +13. Restart your Web server. -13. Now launch the upgrade from the command line using ``occ``, like this +14. Now launch the upgrade from the command line using ``occ``, like this example on Ubuntu Linux:: sudo -u www-data php occ upgrade (!) this MUST be executed from within your nextcloud installation directory -14. The upgrade operation takes a few minutes to a few hours, depending on the +15. The upgrade operation takes a few minutes to a few hours, depending on the size of your installation. When it is finished you will see a success message, or an error message that will tell where it went wrong. -15. Re-enable the nextcloud cron-job. (See step 4 above.) +16. Re-enable the nextcloud cron-job. (See step 4 above.) crontab -u www-data -e diff --git a/admin_manual/maintenance/migrating_owncloud.rst b/admin_manual/maintenance/migrating_owncloud.rst index 8e9307453..fc574745d 100644 --- a/admin_manual/maintenance/migrating_owncloud.rst +++ b/admin_manual/maintenance/migrating_owncloud.rst @@ -15,19 +15,10 @@ See the table below for a version map, where migrating is easily possible: +-------------------+------------------------------+ | ownCloud | Nextcloud | +===================+==============================+ +| 10.11.x | 25.0.x (but at least 25.0.2) | ++-------------------+------------------------------+ | 10.0.5 or later | 20.0.x (but at least 20.0.5) | +-------------------+------------------------------+ -| 10.0.1 - 10.0.5 | 12.0.x (but at least 12.0.1) | -+-------------------+------------------------------+ -| 10.0.0 | 12.0.0 | -+-------------------+------------------------------+ -| 9.1.x | 10.0.x | -+-------------------+------------------------------+ -| 9.0.x | 10.0.x | -+-------------------+------------------------------+ -| 9.0.x | 9.0.x | -+-------------------+------------------------------+ - .. note:: While we understand, that you want to migrate as soon as possible, we also don't want to put your data at risk. Since we never know @@ -54,3 +45,8 @@ See the table below for a version map, where migrating is easily possible: 6. Use the :doc:`Nextcloud built-in updater` to update your instance to the newest version. 7. Make sure to also verify the "Security & setup warnings" in the "Overview" section on the settings page. + +8. In some cases, apps installed from the ownCloud Market might have been disabled as incompatible + (ex: calendar and contacts), so you should reinstall the Nextcloud ones using + ``occ app:enable calendar``, ``occ app:enable contacts``, etc + From 2b0d1b904762adcf446678ec78228f6ec914c789 Mon Sep 17 00:00:00 2001 From: Nextcloud bot Date: Tue, 29 Nov 2022 03:38:58 +0000 Subject: [PATCH 37/95] generate documentation from config.sample.php --- .../configuration_server/config_sample_php_parameters.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index c054d4c8a..ecf3553a9 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -2151,18 +2151,18 @@ Defaults to ``false`` :: - 'minimum.supported.desktop.version' => '2.0.0', + 'minimum.supported.desktop.version' => '2.3.0', The minimum Nextcloud desktop client version that will be allowed to sync with this server instance. All connections made from earlier clients will be denied by the server. Defaults to the minimum officially supported Nextcloud desktop -clientversion at the time of release of this server version. +client version at the time of release of this server version. When changing this, note that older unsupported versions of the Nextcloud desktop client may not function as expected, and could lead to permanent data loss for clients or other unexpected results. -Defaults to ``2.0.0`` +Defaults to ``2.3.0`` :: From eb801780ffb74b13fca520cc5f412f07616e182e Mon Sep 17 00:00:00 2001 From: Matthieu Gallien Date: Tue, 29 Nov 2022 08:45:16 +0100 Subject: [PATCH 38/95] fix typo making server 22 docs to be erroneously about version 21 Signed-off-by: Matthieu Gallien --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 086d6adae..01ee085c8 100644 --- a/index.html +++ b/index.html @@ -330,7 +330,7 @@ Nextcloud Enterprise.

-

Nextcloud 21

+

Nextcloud 22