From 38be1be83bc5eb2b3a1cc8ceb50925976248a9be Mon Sep 17 00:00:00 2001
From: zaggynl <5062119+zaggynl@users.noreply.github.com>
Date: Wed, 2 Nov 2022 19:37:57 +0100
Subject: [PATCH 1/2] Added a section for WinSCP
Added small section for WinSCP with links, Linux through wine and a short howto.
Signed-off-by: zaggynl <5062119+zaggynl@users.noreply.github.com>
---
user_manual/files/access_webdav.rst | 34 +++++++++++++++++++++++++++++
1 file changed, 34 insertions(+)
diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst
index 59611d063..798cda007 100644
--- a/user_manual/files/access_webdav.rst
+++ b/user_manual/files/access_webdav.rst
@@ -515,6 +515,40 @@ To get the properties of files in the root folder:
+
+
+
+
+Accessing files using WinSCP
+-------------------------------
+
+`WinSCP `_ is an open source free SFTP client, FTP client, WebDAV client, S3 client and SCP client for Windows. Its main function is file transfer between a local and a remote computer. Beyond this, WinSCP offers scripting and basic file manager functionality.
+
+You can `download `_ the portable version of WinSCP and run it on Linux through `Wine `_.
+
+To run WinSCP on Linux, download wine through your distribution's package manager, then run it via: wine WinSCP.exe.
+
+To connect to Nextcloud:
+
+* Start WinSCP
+* Press 'Session' in the menu
+* Press the 'New Session' menu option
+* Set the 'File protocol' dropdown to WebDAV
+* Set the 'Encryption' dropdown to TSL/SSL Implicit encryption
+* Fill in the hostname field: example.com
+* Fill in the username field: NEXTCLOUDUSERNAME
+* Fill in the password field: NEXTCLOUDPASSWORD
+* Press the 'Advanced...' button
+* Navigate to 'Environment', 'Directories' on the left side
+* Fill in the 'Remote directory' field with the following: /nextcloud/remote.php/dav/files/NEXTCLOUDUSERNAME/
+* Press the 'OK' button
+* Press the 'Save' button
+* Select the desired options and press the 'OK' button
+* Press the 'Login' button to connect to Nextcloud
+
+Note: at the time of writing (2022-11-02) WinSCP does not seem to understand Nextcloud `2fa `_, it will fail to connect with a 401 Unauthorized message.
+Workaround is to create a separate user without 2fa enabled.
+
.. _KB2668751: https://web.archive.org/web/20211008025539/https://support.microsoft.com/en-us/topic/you-cannot-download-more-than-50-mb-or-upload-large-files-when-the-upload-takes-longer-than-30-minutes-using-web-client-in-windows-7-8709ae9d-e808-c5a0-95d0-9a7143c50b11
From e7fb94ab6228e20d7ecdeb3818bd683e2a80262b Mon Sep 17 00:00:00 2001
From: zaggynl <5062119+zaggynl@users.noreply.github.com>
Date: Mon, 7 Nov 2022 19:39:44 +0100
Subject: [PATCH 2/2] Updated text with reminder about using app password.
Updated text with reminder to use app password if you have TOTP setup, as WinSCP shows a 401 Unauthorized message on attempt to login with username/password if TOTP setup on Nextcloud.
Signed-off-by: zaggynl <5062119+zaggynl@users.noreply.github.com>
---
user_manual/files/access_webdav.rst | 3 +--
1 file changed, 1 insertion(+), 2 deletions(-)
diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst
index 798cda007..4d9c084ff 100644
--- a/user_manual/files/access_webdav.rst
+++ b/user_manual/files/access_webdav.rst
@@ -546,8 +546,7 @@ To connect to Nextcloud:
* Select the desired options and press the 'OK' button
* Press the 'Login' button to connect to Nextcloud
-Note: at the time of writing (2022-11-02) WinSCP does not seem to understand Nextcloud `2fa `_, it will fail to connect with a 401 Unauthorized message.
-Workaround is to create a separate user without 2fa enabled.
+Note: it is recommended to use an app password for the password if you use TOTP, as WinSCP does not understand TOTP in Nextcloud at the time of writing (2022-11-07).