harilvfs · December 22, 2024 17:21 · Jul 13, 2021 · May 20, 2021
diff --git a/gh-installation.md b/gh-installation.md
@@ -1,5 +1,6 @@
 # Installing gh on Linux and FreeBSD
 
+**(From cli/cli)**
 Packages downloaded from https://cli.github.com or from https://github.com/cli/cli/releases
 are considered official binaries. We focus on popular Linux distros and
 the following CPU architectures: `i386`, `amd64`, `arm64`.

diff --git a/gh-installation.md b/gh-installation.md
@@ -0,0 +1,201 @@
+# Installing gh on Linux and FreeBSD
+
+Packages downloaded from https://cli.github.com or from https://github.com/cli/cli/releases
+are considered official binaries. We focus on popular Linux distros and
+the following CPU architectures: `i386`, `amd64`, `arm64`.
+
+Other sources for installation are community-maintained and thus might lag behind
+our release schedule.
+
+If none of our official binaries, packages, repositories, nor community sources work for you, we recommend using our `Makefile` to build `gh` from source. It's quick and easy.
+
+## Official sources
+
+### Debian, Ubuntu Linux (apt)
+
+Install (Using apt-key):
+
+```bash
+sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key C99B11DEB97541F0
+sudo apt-add-repository https://cli.github.com/packages
+sudo apt update
+sudo apt install gh
+```
+
+**Note**: If you are behind a firewall, the connection to `keyserver.ubuntu.com` might fail. In that case, try running `sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C99B11DEB97541F0`.
+
+**Note**: If you get _"gpg: failed to start the dirmngr '/usr/bin/dirmngr': No such file or directory"_ error, try installing the `dirmngr` package. Run `sudo apt-get install dirmngr` and repeat the steps above.  
+
+**Note**: most systems will have `apt-add-repository` already. If you get a _command not found_
+error, try running `sudo apt install software-properties-common` and trying these steps again.
+
+Install (without add-apt-repository, with limited keyring scope):
+```bash
+sudo apt-key --keyring /usr/share/keyrings/githubcli-archive-keyring.gpg adv --keyserver keyserver.ubuntu.com --recv-key C99B11DEB97541F0
+echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/github-cli2.list > /dev/null
+sudo apt update
+sudo apt install gh
+```
+
+Upgrade:
+
+```bash
+sudo apt update
+sudo apt install gh
+```
+
+### Fedora, CentOS, Red Hat Enterprise Linux (dnf)
+
+Install:
+
+```bash
+sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
+sudo dnf install gh
+```
+
+Upgrade:
+
+```bash
+sudo dnf update gh
+```
+
+### openSUSE/SUSE Linux (zypper)
+
+Install:
+
+```bash
+sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo
+sudo zypper ref
+sudo zypper install gh
+```
+
+Upgrade:
+
+```bash
+sudo zypper ref
+sudo zypper update gh
+```
+
+## Manual installation
+
+* [Download release binaries][releases page] that match your platform; or
+* [Build from source](./source.md).
+
+### openSUSE/SUSE Linux (zypper)
+
+Install and upgrade:
+
+1. Download the `.rpm` file from the [releases page][];
+2. Install the downloaded file: `sudo zypper in gh_*_linux_amd64.rpm`
+
+## Unofficial, Community-supported methods
+
+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.
+
+### Arch Linux
+
+Arch Linux users can install from the [community repo][arch linux repo]:
+
+```bash
+sudo pacman -S github-cli
+```
+
+Alternatively, use the [unofficial AUR package][arch linux aur] to build GitHub CLI from source.
+
+### Android
+
+Android 7+ users can install via [Termux](https://wiki.termux.com/wiki/Main_Page):
+
+```bash
+pkg install gh
+```
+
+### Homebrew (Linuxbrew)
+
+Linuxbrew users can install it as a [brew package](https://formulae.brew.sh/formula/gh#default):
+```bash
+brew install gh
+```
+
+### FreeBSD
+
+FreeBSD users can install from the [ports collection](https://www.freshports.org/devel/gh/):
+
+```bash
+cd /usr/ports/devel/gh/ && make install clean
+```
+
+Or via [pkg(8)](https://www.freebsd.org/cgi/man.cgi?pkg(8)):
+
+```bash
+pkg install gh
+```
+
+### Funtoo
+
+Funtoo Linux has an autogenerated github-cli package, located in [dev-kit](https://github.com/funtoo/dev-kit/tree/1.4-release/dev-util/github-cli), which can be installed in the following way:
+
+``` bash
+emerge -av github-cli
+```
+
+Upgrading can be done by syncing the repos and then requesting an upgrade:
+
+``` bash
+ego sync
+emerge -u github-cli
+```
+
+### Gentoo
+
+Gentoo Linux users can install from the [main portage tree](https://packages.gentoo.org/packages/dev-util/github-cli):
+
+``` bash
+emerge -av github-cli
+```
+
+Upgrading can be done by updating the portage tree and then requesting an upgrade:
+
+``` bash
+emerge --sync
+emerge -u github-cli
+```
+
+### Kiss Linux
+
+Kiss Linux users can install from the [community repos](https://github.com/kisslinux/community):
+
+```bash
+kiss b github-cli && kiss i github-cli
+```
+
+### Nix/NixOS
+
+Nix/NixOS users can install from [nixpkgs](https://search.nixos.org/packages?show=gitAndTools.gh&query=gh&from=0&size=30&sort=relevance&channel=20.03#disabled):
+
+```bash
+nix-env -iA nixos.gitAndTools.gh
+```
+
+### openSUSE Tumbleweed
+
+openSUSE Tumbleweed users can install from the [offical distribution repo](https://software.opensuse.org/package/gh):
+```bash
+sudo zypper in gh
+```
+
+### Snaps
+
+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)
+
+```bash
+sudo snap install --edge gh && snap connect gh:ssh-keys
+```
+> Snaps are auto-updated every 6 hours. `Snapd` is required and is available on a wide range of Linux distros.
+> Find out which distros have Snapd pre-installed and how to install it in the [Snapcraft Installation Docs](https://snapcraft.io/docs/installing-snapd)
+>
+> **Note:** `snap connect gh:ssh-keys` is needed for all authentication and SSH needs.
+
+[releases page]: https://github.com/cli/cli/releases/latest
+[arch linux repo]: https://www.archlinux.org/packages/community/x86_64/github-cli
+[arch linux aur]: https://aur.archlinux.org/packages/github-cli-git