From 3e49149372f27608e9c16402758a922d82fd1b98 Mon Sep 17 00:00:00 2001 From: Camila Ayres Date: Wed, 11 Mar 2026 14:38:32 +0100 Subject: [PATCH 1/6] docs(desktop): update installation.rst with note about Citrix Signed-off-by: Camila Ayres --- user_manual/desktop/installation.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/user_manual/desktop/installation.rst b/user_manual/desktop/installation.rst index d6da02d74..b19ea9450 100644 --- a/user_manual/desktop/installation.rst +++ b/user_manual/desktop/installation.rst @@ -30,16 +30,22 @@ KWallet, so that the sync client can login automatically. You will also find links to source code archives and older versions on the download page. +.. _system_requirements: System Requirements ---------------------------------- - Windows 10+ (64-bits only) - macOS 12.0+ (64-bits only) - Linux (Ubuntu 22.04 or openSUSE 15.5 or Alma 8 or ...) (64-bits only) + For Linux distributions, we support, if technically feasible, the current LTS releases. + For BSD, we support them if technically feasible but we do not test. .. note:: - For Linux distributions, we support, if technically feasible, the current LTS releases. - For BSD, we support them if technically feasible but we do not test + We do not support Citrix. + + - We will do our best to advise Citrix users from the desktop client point of view. + - We will fix issues that are also reproducible on the standard supported systems. + - Everything else is outside of our scope. Customizing the Windows Installation ------------------------------------ From e9c83bff5574aa1e50342e28557707c0a5155c05 Mon Sep 17 00:00:00 2001 From: Camila Ayres Date: Wed, 11 Mar 2026 15:13:53 +0100 Subject: [PATCH 2/6] docs(desktop): add note about Citrix in config file and troubleshooting sessions. Signed-off-by: Camila Ayres --- admin_manual/desktop/configfile.rst | 5 ++++- admin_manual/desktop/troubleshooting.rst | 12 ++++++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/admin_manual/desktop/configfile.rst b/admin_manual/desktop/configfile.rst index 73692bffe..4a2f3cea1 100644 --- a/admin_manual/desktop/configfile.rst +++ b/admin_manual/desktop/configfile.rst @@ -1,7 +1,7 @@ ================== Configuration File ================== - +.. _configuration_files: The Nextcloud Client reads a configuration file. You can locate this configuration file as follows: On Linux distributions: @@ -13,6 +13,9 @@ On Microsoft Windows systems: On macOS systems: ``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg`` +.. note:: + In a Citrix workspace, the user's Roaming profile needs to be persisted between sessions. + The failure on doing so will result in result in users having to set up their account again in every new session. The configuration file contains settings using the Microsoft Windows .ini file format. You can overwrite changes using the Nextcloud configuration dialog. diff --git a/admin_manual/desktop/troubleshooting.rst b/admin_manual/desktop/troubleshooting.rst index c9b35906f..58f14bca2 100644 --- a/admin_manual/desktop/troubleshooting.rst +++ b/admin_manual/desktop/troubleshooting.rst @@ -324,3 +324,15 @@ the current working directory. your system, ensure that you have enough disk space to accommodate these files. Also, due to their size, we strongly recommend that you properly compress any core dump files prior to sending them to Nextcloud Customer Support. + +Citrix Workspace known issues +----------------------------- + +These are known issues when running the desktop client in a Citrix workspace: + - The Windows user's Roaming profile needs to be persisted between sessions - see :ref:`configuration_files`. + The failure on doing so will result in result in users having to set up their account again in every new session. + - Every time the user logs in a Citrix environment, it creates a session with the desktop client and in that session the client will sync the user's files, + that can quickly lead to the storage running out of space. + +For more information on Citrix support: +- :ref:`system_requirements` \ No newline at end of file From 126139f7afb8fa991d0405a4b08da4a75fff4649 Mon Sep 17 00:00:00 2001 From: Camila Ayres Date: Wed, 11 Mar 2026 18:44:16 +0100 Subject: [PATCH 3/6] fix(desktop): references. Signed-off-by: Camila Ayres --- admin_manual/desktop/configfile.rst | 4 ++-- admin_manual/desktop/troubleshooting.rst | 5 +---- user_manual/desktop/installation.rst | 1 - 3 files changed, 3 insertions(+), 7 deletions(-) diff --git a/admin_manual/desktop/configfile.rst b/admin_manual/desktop/configfile.rst index 4a2f3cea1..956b3d0bc 100644 --- a/admin_manual/desktop/configfile.rst +++ b/admin_manual/desktop/configfile.rst @@ -1,7 +1,7 @@ ================== Configuration File ================== -.. _configuration_files: +.. _configfile: The Nextcloud Client reads a configuration file. You can locate this configuration file as follows: On Linux distributions: @@ -88,4 +88,4 @@ Some interesting values that can be set on the configuration file are: | | | ``2`` for No Proxy. | + + +--------------------------------------------------------------------------------------------------------+ | | | ``3`` for HTTP(S) Proxy. | -+---------------------------------+---------------+--------------------------------------------------------------------------------------------------------+ ++---------------------------------+---------------+--------------------------------------------------------------------------------------------------------+ \ No newline at end of file diff --git a/admin_manual/desktop/troubleshooting.rst b/admin_manual/desktop/troubleshooting.rst index 58f14bca2..a43fc45cf 100644 --- a/admin_manual/desktop/troubleshooting.rst +++ b/admin_manual/desktop/troubleshooting.rst @@ -329,10 +329,7 @@ Citrix Workspace known issues ----------------------------- These are known issues when running the desktop client in a Citrix workspace: - - The Windows user's Roaming profile needs to be persisted between sessions - see :ref:`configuration_files`. + - The Windows user's Roaming profile needs to be persisted between sessions - see :ref:`Config file `:: The failure on doing so will result in result in users having to set up their account again in every new session. - Every time the user logs in a Citrix environment, it creates a session with the desktop client and in that session the client will sync the user's files, that can quickly lead to the storage running out of space. - -For more information on Citrix support: -- :ref:`system_requirements` \ No newline at end of file diff --git a/user_manual/desktop/installation.rst b/user_manual/desktop/installation.rst index b19ea9450..b9b894a41 100644 --- a/user_manual/desktop/installation.rst +++ b/user_manual/desktop/installation.rst @@ -30,7 +30,6 @@ KWallet, so that the sync client can login automatically. You will also find links to source code archives and older versions on the download page. -.. _system_requirements: System Requirements ---------------------------------- From 673f5f5355bf6c5217b3d38d87aeb967634e9ef7 Mon Sep 17 00:00:00 2001 From: Camila Ayres Date: Wed, 11 Mar 2026 19:04:07 +0100 Subject: [PATCH 4/6] docs(desktop): extend Citrix issue about persisting data between sessions. Signed-off-by: Camila Ayres --- admin_manual/desktop/configfile.rst | 6 +++--- admin_manual/desktop/troubleshooting.rst | 2 ++ 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/admin_manual/desktop/configfile.rst b/admin_manual/desktop/configfile.rst index 956b3d0bc..5f29fac0b 100644 --- a/admin_manual/desktop/configfile.rst +++ b/admin_manual/desktop/configfile.rst @@ -13,9 +13,9 @@ On Microsoft Windows systems: On macOS systems: ``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg`` -.. note:: - In a Citrix workspace, the user's Roaming profile needs to be persisted between sessions. - The failure on doing so will result in result in users having to set up their account again in every new session. +.. note:: + In a Citrix workspace, the user's Roaming profile need to be persisted between sessions. + The failure on doing so will result in users having to set up their account again in every new session. The configuration file contains settings using the Microsoft Windows .ini file format. You can overwrite changes using the Nextcloud configuration dialog. diff --git a/admin_manual/desktop/troubleshooting.rst b/admin_manual/desktop/troubleshooting.rst index a43fc45cf..7dae63b23 100644 --- a/admin_manual/desktop/troubleshooting.rst +++ b/admin_manual/desktop/troubleshooting.rst @@ -331,5 +331,7 @@ Citrix Workspace known issues These are known issues when running the desktop client in a Citrix workspace: - The Windows user's Roaming profile needs to be persisted between sessions - see :ref:`Config file `:: The failure on doing so will result in result in users having to set up their account again in every new session. + - The user's synchronization folder also needs to be persisted between sessions. + The client will throw errors because it can not find the sync folder once the users logs in a new session. - Every time the user logs in a Citrix environment, it creates a session with the desktop client and in that session the client will sync the user's files, that can quickly lead to the storage running out of space. From 29d9a53b538c6de75b1bb872ff3571c724d5c9d6 Mon Sep 17 00:00:00 2001 From: Camila Ayres Date: Wed, 11 Mar 2026 19:12:23 +0100 Subject: [PATCH 5/6] docs(desktop): update Ubuntu version. Signed-off-by: Camila Ayres --- user_manual/desktop/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/desktop/installation.rst b/user_manual/desktop/installation.rst index b9b894a41..81e8b3796 100644 --- a/user_manual/desktop/installation.rst +++ b/user_manual/desktop/installation.rst @@ -35,7 +35,7 @@ System Requirements - Windows 10+ (64-bits only) - macOS 12.0+ (64-bits only) -- Linux (Ubuntu 22.04 or openSUSE 15.5 or Alma 8 or ...) (64-bits only) +- Linux (Ubuntu 24.04 or openSUSE 15.5 or Alma 8 or ...) (64-bits only) For Linux distributions, we support, if technically feasible, the current LTS releases. For BSD, we support them if technically feasible but we do not test. From a0ad4455d8b8f12153b058bacfcbd07ce34ef1c6 Mon Sep 17 00:00:00 2001 From: Camila Ayres Date: Wed, 11 Mar 2026 19:16:30 +0100 Subject: [PATCH 6/6] fix(desktop): fix syntax issues. Signed-off-by: Camila Ayres --- admin_manual/desktop/configfile.rst | 2 +- admin_manual/desktop/troubleshooting.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/admin_manual/desktop/configfile.rst b/admin_manual/desktop/configfile.rst index 5f29fac0b..3fca2d19d 100644 --- a/admin_manual/desktop/configfile.rst +++ b/admin_manual/desktop/configfile.rst @@ -1,7 +1,7 @@ ================== Configuration File ================== -.. _configfile: + The Nextcloud Client reads a configuration file. You can locate this configuration file as follows: On Linux distributions: diff --git a/admin_manual/desktop/troubleshooting.rst b/admin_manual/desktop/troubleshooting.rst index 7dae63b23..271add45b 100644 --- a/admin_manual/desktop/troubleshooting.rst +++ b/admin_manual/desktop/troubleshooting.rst @@ -329,7 +329,7 @@ Citrix Workspace known issues ----------------------------- These are known issues when running the desktop client in a Citrix workspace: - - The Windows user's Roaming profile needs to be persisted between sessions - see :ref:`Config file `:: + - The Windows user's Roaming profile needs to be persisted between sessions. The failure on doing so will result in result in users having to set up their account again in every new session. - The user's synchronization folder also needs to be persisted between sessions. The client will throw errors because it can not find the sync folder once the users logs in a new session.