From 1006b78b10456f1ec4601efbea8e7444713bb740 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 d6da02d7491..b19ea945052 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 61c181488d7cc5f7c0fe3ff59acc108f7b5ae9c9 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 73692bffe4d..4a2f3cea1fc 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 c9b35906fa0..58f14bca242 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 1e134b7b3e6bf13b9a5028b683dbce9c2a7ed7d7 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 4a2f3cea1fc..956b3d0bc51 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 58f14bca242..a43fc45cf93 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 b19ea945052..b9b894a41b8 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 0141b2b86a5d0e952666d715c13d6ec6743f8881 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 956b3d0bc51..5f29fac0b8a 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 a43fc45cf93..7dae63b237c 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 13252715a792e83da1c1f4526c5ade82fc0ff5fb 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 b9b894a41b8..81e8b3796f7 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 11dc94197039030e01cccbf171e9cc7abe0b3717 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 5f29fac0b8a..3fca2d19dd1 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 7dae63b237c..271add45bb0 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.