From 1b7d98895c3c5fd2b030a29ecab3a05f8509147a Mon Sep 17 00:00:00 2001 From: Amy Qualls Date: Thu, 28 Aug 2025 13:37:06 -0700 Subject: [PATCH 1/3] docs: Alphabetize Linux install options Bring these back to a semblance of order. --- docs/installation_options.md | 76 ++++++++++++++++++------------------ 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/docs/installation_options.md b/docs/installation_options.md index 7fec1ca72..c3005b7ec 100644 --- a/docs/installation_options.md +++ b/docs/installation_options.md @@ -15,19 +15,19 @@ are maintained by the community. - [Windows](#windows) - [Linux](#linux) - [Homebrew](#homebrew) - - [mise-en-place](#mise-en-place) - [ASDF](#asdf) - - [Snapcraft (currently out of date)](#snapcraft) - [Arch Linux](#arch-linux) - [Alpine Linux](#alpine-linux) - [Install a pinned version from edge](#install-a-pinned-version-from-edge) - [Alpine Linux Docker-way](#alpine-linux-docker-way) - [Fedora](#fedora) - - [Nix/NixOS](#nixnixos) - - [WakeMeOps (Debian/Ubuntu)](#wakemeops-debianubuntu) + - [mise-en-place](#mise-en-place) - [MPR (Debian/Ubuntu)](#mpr-debianubuntu) - [Prebuilt-MPR](#prebuilt-mpr) + - [Nix/NixOS](#nixnixos) + - [Snapcraft (out of date)](#snapcraft) - [Spack](#spack) + - [WakeMeOps (Debian/Ubuntu)](#wakemeops-debianubuntu) - [Docker](#docker) - [GitLab CICD](#gitlab-cicd) @@ -82,16 +82,6 @@ Installing from Homebrew is the officially supported installation method for Lin - Install with: `brew install glab` - Update with: `brew upgrade glab` -### mise-en-place - -Add to the `[tools]` section of one of mise's configuration files: - -```toml -"ubi:gitlab-org/cli" = { version = "latest", exe = "glab", provider = "gitlab" } -``` - -Then run `mise install` to install it. - ### ASDF To install with the [ASDF tool version manager](https://asdf-vm.com/guide/introduction.html), run these commands: @@ -100,18 +90,6 @@ To install with the [ASDF tool version manager](https://asdf-vm.com/guide/introd asdf plugin add glab; asdf install glab latest; asdf global glab latest ``` -### Snapcraft - -This method is out of date. See [issue 1127](https://gitlab.com/gitlab-org/cli/-/issues/1127) for more information. - -To install `glab` from the [Snap Store](https://snapcraft.io/glab): - -1. Make sure you have [snap installed](https://snapcraft.io/docs/installing-snapd) on your Linux distribution. -1. Install the package: `sudo snap install --edge glab` -1. Grant `glab` access to SSH keys: `sudo snap connect glab:ssh-keys` - -[![Download from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/glab) - ### Arch Linux For Arch Linux, `glab` is available: @@ -169,22 +147,16 @@ Fedora users can find `glab` as `glab` in the official repositories. Install it with the command `dnf install glab`. -### Nix/NixOS - -Nix (NixOS) users can install from [nixpkgs](https://search.nixos.org/packages?channel=unstable&show=glab&from=0&size=30&sort=relevance&query=glab) with the command `nix-env -iA nixos.glab`. - -### WakeMeOps (Debian/Ubuntu) - -`glab` also exists in the [WakeMeOps repository](https://docs.wakemeops.com/packages/glab/): +### mise-en-place -```shell -# Add WakeMeOps repository -curl -sSL "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | sudo bash +Add to the `[tools]` section of one of mise's configuration files: -# Install glab -sudo apt install glab +```toml +"ubi:gitlab-org/cli" = { version = "latest", exe = "glab", provider = "gitlab" } ``` +Then run `mise install` to install it. + ### MPR (Debian/Ubuntu) `glab` is available inside the [makedeb package repository](https://mpr.makedeb.org/packages/glab). To install, run the following: @@ -202,11 +174,39 @@ The above method downloads `glab` from source and builds it before packaging it 1. Set up [the Prebuilt-MPR on your system](https://docs.makedeb.org/prebuilt-mpr/getting-started/#setting-up-the-repository). 1. Install with the command `sudo apt install glab`. +### Nix/NixOS + +Nix (NixOS) users can install from [nixpkgs](https://search.nixos.org/packages?channel=unstable&show=glab&from=0&size=30&sort=relevance&query=glab) with the command `nix-env -iA nixos.glab`. + +### Snapcraft + +This method is out of date. See [issue 1127](https://gitlab.com/gitlab-org/cli/-/issues/1127) for more information. + +To install `glab` from the [Snap Store](https://snapcraft.io/glab): + +1. Make sure you have [snap installed](https://snapcraft.io/docs/installing-snapd) on your Linux distribution. +1. Install the package: `sudo snap install --edge glab` +1. Grant `glab` access to SSH keys: `sudo snap connect glab:ssh-keys` + +[![Download from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/glab) + ### Spack - To install: `spack install glab`. - To update: `spack uninstall glab && spack install glab` +### WakeMeOps (Debian/Ubuntu) + +`glab` also exists in the [WakeMeOps repository](https://docs.wakemeops.com/packages/glab/): + +```shell +# Add WakeMeOps repository +curl -sSL "https://raw.githubusercontent.com/upciti/wakemeops/main/assets/install_repository" | sudo bash + +# Install glab +sudo apt install glab +``` + ## Docker A Docker image for `glab` is available at -- GitLab From d69d19c073cf63007a98ac473f0c0bbf8272bc08 Mon Sep 17 00:00:00 2001 From: Amy Qualls Date: Thu, 28 Aug 2025 13:40:12 -0700 Subject: [PATCH 2/3] docs: Add conda-forge as an option If it exists, we can add it. --- docs/installation_options.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/installation_options.md b/docs/installation_options.md index c3005b7ec..adf6351ab 100644 --- a/docs/installation_options.md +++ b/docs/installation_options.md @@ -141,6 +141,12 @@ RUN echo "@edge http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk RUN apk add --no-cache glab@edge ``` +### Conda-forge + +Conda-forge users can find `glab` on [conda-forge](https://github.com/conda-forge/glab-feedstock). + +Install it globally with the command `pixi global install glab`. + ### Fedora Fedora users can find `glab` as `glab` in the official repositories. -- GitLab From 1c0aa5eee027f86a3d2d40f0c34f23da922b19c9 Mon Sep 17 00:00:00 2001 From: Amy Qualls Date: Thu, 28 Aug 2025 13:41:03 -0700 Subject: [PATCH 3/3] docs: Mark item as officially supported in TOC Make clearer that Homebrew is the preferred choice. --- docs/installation_options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/installation_options.md b/docs/installation_options.md index adf6351ab..eeaac5670 100644 --- a/docs/installation_options.md +++ b/docs/installation_options.md @@ -14,7 +14,7 @@ are maintained by the community. - [macOS](#macos) - [Windows](#windows) - [Linux](#linux) - - [Homebrew](#homebrew) + - [Homebrew](#homebrew) (officially supported) - [ASDF](#asdf) - [Arch Linux](#arch-linux) - [Alpine Linux](#alpine-linux) -- GitLab