Skip to content

Commit 984d374

Browse files
committed
install-from-source: add instructions to uninstall
Add instructions for Linux users on supported distros to remove GCM and its dependencies after installing from source.
1 parent 5f8fc4d commit 984d374

File tree

2 files changed

+59
-0
lines changed

2 files changed

+59
-0
lines changed

docs/faq.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,3 +146,7 @@ and pick "Revoke access".
146146
![Revoke GCM OAuth app access](img/github-oauthapp-revoke.png)
147147

148148
After revoking access, any tokens created by GCM will be invalidated and can no longer be used to access your repositories. The next time GCM attempts to access GitHub.com you will be prompted to consent again.
149+
150+
### I used the install from source script to install GCM on my Linux distribution. Now how can I uninstall GCM and its dependencies?
151+
152+
Please see full instructions [here](./linux-fromsrc-uninstall.md).

docs/linux-fromsrc-uninstall.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Uninstalling after installing from source
2+
3+
These instructions will guide you in removing GCM after running the [install from source script](../src/linux/Packaging.Linux/install-from-source.sh) on your Linux distribution.
4+
5+
:siren: PROCEED WITH CAUTION :siren:
6+
7+
For completeness, we provide uninstall instructions for _the GCM application, the GCM repo, and the maximum number of dependencies*_ for all distributions. This repo and these dependencies may or may not have already been present on your system when you ran the install from source script, and uninstalling them could impact other programs and/or your normal workflows. Please keep this in mind when following the instructions below.
8+
9+
*Certain distributions require some dependencies of the script to function as expected, so we only include instructions to remove the non-required dependencies.
10+
11+
## All distributions
12+
13+
**Note:** If you ran the install from source script from a pre-existing clone of the `git-credential-manager` repo or outside of your `$HOME` directory, you will need to modify the final two commands below to point to the location of your pre-existing clone or the directory from which you ran the install from source script.
14+
15+
```console
16+
git-credential-manager-core unconfigure &&
17+
sudo rm $(command -v git-credential-manager-core) &&
18+
sudo rm -rf /usr/local/share/gcm-core &&
19+
sudo rm -rf ~/git-credential-manager &&
20+
sudo rm ~/install-from-source.sh
21+
```
22+
23+
## Debian/Ubuntu
24+
25+
**Note:** If you had a pre-existing installation of dotnet that was not installed via `apt` or `apt-get` when you ran the install from source script, you will need to remove it using [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/remove-runtime-sdk-versions?pivots=os-linux#uninstall-net) and remove `dotnet-*` from the below command.
26+
27+
```console
28+
sudo apt remove dotnet-* dpkg-dev apt-transport-https git curl wget
29+
```
30+
31+
## Linux Mint
32+
33+
**Note:** If you had a pre-existing installation of dotnet when you ran the install from source script that was not located at `~/.dotnet`, you will need to modify the first command below to point to the custom install location. If you would like to remove the specific version of dotnet that the script installed and keep other versions, you can do so with [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/remove-runtime-sdk-versions?pivots=os-linux#uninstall-net).
34+
35+
```console
36+
sudo rm -rf ~/.dotnet &&
37+
sudo apt remove git curl
38+
```
39+
40+
## Fedora/CentOS/RHEL
41+
42+
**Note:** If you had a pre-existing installation of dotnet when you ran the install from source script that was not located at `~/.dotnet`, you will need to modify the first command below to point to the custom install location. If you would like to remove the specific version of dotnet that the script installed and keep other versions, you can do so with [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/remove-runtime-sdk-versions?pivots=os-linux#uninstall-net).
43+
44+
```console
45+
sudo rm -rf ~/.dotnet
46+
```
47+
48+
## Alpine
49+
50+
**Note:** If you had a pre-existing installation of dotnet when you ran the install from source script that was not located at `~/.dotnet`, you will need to modify the first command below to point to the custom install location. If you would like to remove the specific version of dotnet that the script installed and keep other versions, you can do so with [these instructions](https://docs.microsoft.com/en-us/dotnet/core/install/remove-runtime-sdk-versions?pivots=os-linux#uninstall-net).
51+
52+
```console
53+
sudo rm -rf ~/.dotnet &&
54+
sudo apk del icu-libs krb5-libs libgcc libintl libssl1.1 libstdc++ zlib which bash coreutils gcompat git curl
55+
```

0 commit comments

Comments
 (0)