Skip to content

Commit 4e4cb08

Browse files
camilasanmiaulalala
authored andcommitted
docs(user_manual/desktop): add instructions on how to remove the desktop client.
Signed-off-by: Camila Ayres <hello@camilasan.com>
1 parent 92a1ac2 commit 4e4cb08

2 files changed

Lines changed: 73 additions & 0 deletions

File tree

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)