Skip to content

Commit f93803b

Browse files
authored
Merge pull request #14328 from nextcloud/feat/desktop/uninstall
docs(user_manual/desktop): add instruction on how to safely remove the desktop client.
2 parents 2d64c71 + 7d4d007 commit f93803b

3 files changed

Lines changed: 76 additions & 1 deletion

File tree

admin_manual/desktop/configfile.rst

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,9 @@ On Microsoft Windows systems:
1111
``%APPDATA%\Nextcloud\nextcloud.cfg``
1212

1313
On macOS systems:
14-
``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg``
14+
Starting with version 33.0.0: ``$HOME/Library/Containers/com.nextcloud.desktopclient/Data/Library/Preferences/Nextcloud/nextcloud.cfg``
15+
16+
On older versions: ``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg``
1517

1618
.. note::
1719
In a Citrix workspace, the user's Roaming profile need to be persisted between sessions.

user_manual/desktop/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ Your files are always automatically synchronized between your Nextcloud server,
1515
:maxdepth: 1
1616

1717
installation
18+
uninstallation
1819
usage
1920
macosvfs
2021
autoupdate
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
==============
2+
Uninstallation
3+
==============
4+
5+
It is safe to uninstall the files desktop client by using the built-in tools within your operating system.
6+
7+
General instructions
8+
--------------------
9+
In each operating system:
10+
11+
1. Make sure to *quit the desktop client* before removing it.
12+
13+
2. *Uninstall* the desktop client.
14+
15+
3. You may also need to take into consideration that uninstalling the desktop client will not remove the `user's configuration <https://docs.nextcloud.com/server/latest/admin_manual/desktop/configfile.html#configuration-file>`_ file and synced data.
16+
17+
For data removal (sync folders), consider using the server feature `remote wipe <https://nextcloud.com/de/blog/nextcloud-desktop-client-2-6-1-brings-remote-wipe-dark-mode-support-to-mac-os-x-and-more/>`_. This feature is available across all clients.
18+
19+
Below are platform specific instructions.
20+
21+
Windows
22+
^^^^^^^
23+
There are two ways of removing the desktop client:
24+
25+
1. Using `Add or Remove Programs`.
26+
27+
2. You can use the `msiexec <https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options>`_ command line options:
28+
29+
.. code-block:: shell
30+
31+
msiexec /uninstall Nextcloud-x.y.z-x64.msi /quiet``
32+
33+
3. The `user's configuration <https://docs.nextcloud.com/server/latest/admin_manual/desktop/configfile.html#configuration-file>`_ is located at ``%APPDATA%\Nextcloud\nextcloud.cfg``.
34+
35+
macOS
36+
^^^^^
37+
Beyond deleting the desktop client from the *Applications* folder, you may also need to remove all related data, specially if you are using virtual files.
38+
39+
1. To simply uninstall the software: you can do this from the `Launchpad or the Finder <https://support.apple.com/en-us/102610>`_.
40+
41+
2. For the complete removal of all related data, the following commands can be used:
42+
43+
.. code-block:: bash
44+
45+
rm -rf "$HOME/Library/Application Scripts/com.nextcloud.desktopclient"*
46+
rm -f "$HOME/Library/Application Support/CrashReporter/Nextcloud_"*
47+
rm -rf "$HOME/Library/Application Support/Nextcloud"
48+
rm -rf "$HOME/Library/Caches/Nextcloud"
49+
rm -rf "$HOME/Library/Containers/com.nextcloud.desktopclient"*
50+
rm -rf "$HOME/Library/Group Containers/NKUJUXUJ3B.com.nextcloud.desktopclient"
51+
rm -rf "$HOME/Library/Group Containers/com.nextcloud.desktopclient"
52+
rm -f "$HOME/Library/LaunchAgents/com.nextcloud.desktopclient.plist"
53+
rm -rf "$HOME/Library/Preferences/Nextcloud"
54+
rm -f "$HOME/Library/Preferences/com.nextcloud.desktopclient.plist"
55+
56+
3. From version 33.0.0 the `user's configuration <https://docs.nextcloud.com/server/latest/admin_manual/desktop/configfile.html#configuration-file>`_ is located at ``$HOME/Library/Containers/com.nextcloud.desktopclient/Data/Library/Preferences/Nextcloud/nextcloud.cfg``.
57+
On older versions it is located at ``$HOME/Library/Preferences/Nextcloud/nextcloud.cfg``.
58+
59+
Linux
60+
^^^^^
61+
It depends on how you installed the desktop client:
62+
63+
1. If you are running the Nextcloud AppImage, you can simply delete the AppImage file.
64+
65+
2. If you have used your package manager to install the desktop client, you can use it to uninstall the desktop client as well. For example, on Ubuntu you can use the following command:
66+
67+
.. code-block:: bash
68+
69+
sudo apt remove nextcloud-desktop
70+
71+
3. The `user's configuration <https://docs.nextcloud.com/server/latest/admin_manual/desktop/configfile.html#configuration-file>`_ is located at *$HOME/.config/Nextcloud/nextcloud.cfg*.
72+

0 commit comments

Comments
 (0)