Skip to content

Commit ca60e30

Browse files
committed
Add warning about Snap
1 parent 05328fb commit ca60e30

File tree

1 file changed

+4
-12
lines changed

1 file changed

+4
-12
lines changed

docs/install_linux.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,10 @@ Install and upgrade:
8383

8484
The core GitHub CLI team does not maintain the following packages or repositories. They are unofficial and we are unable to provide support or guarantees for them. They are linked here as a convenience and their presence does not imply continued oversight from the CLI core team. Users who choose to use them do so at their own risk.
8585

86+
### Snap (do not use)
87+
88+
There are [so many issues with Snap](https://github.com/casperdcl/cli/issues/7) as a runtime mechanism for apps like GitHub CLI that our team suggests _never installing gh as a snap_.
89+
8690
### Arch Linux
8791

8892
Arch Linux users can install from the [community repo][arch linux repo]:
@@ -175,18 +179,6 @@ openSUSE Tumbleweed users can install from the [official distribution repo](http
175179
sudo zypper in gh
176180
```
177181

178-
### Snaps
179-
180-
Many Linux distro users can install using Snapd from the [Snap Store](https://snapcraft.io/gh) or the associated [repo](https://github.com/casperdcl/cli/tree/snap)
181-
182-
```bash
183-
sudo snap install --edge gh && snap connect gh:ssh-keys
184-
```
185-
> Snaps are auto-updated every 6 hours. `Snapd` is required and is available on a wide range of Linux distros.
186-
> Find out which distros have Snapd pre-installed and how to install it in the [Snapcraft Installation Docs](https://snapcraft.io/docs/installing-snapd)
187-
>
188-
> **Note:** `snap connect gh:ssh-keys` is needed for all authentication and SSH needs.
189-
190182
[releases page]: https://github.com/cli/cli/releases/latest
191183
[arch linux repo]: https://www.archlinux.org/packages/community/x86_64/github-cli
192184
[arch linux aur]: https://aur.archlinux.org/packages/github-cli-git

0 commit comments

Comments
 (0)