From 5e274abe8af86a408b99cf37ed0dd7610af3a762 Mon Sep 17 00:00:00 2001 From: Stefan Haller Date: Tue, 3 Nov 2026 20:28:31 +0100 Subject: [PATCH] Explain in the README how to install a release that updates itself The update menu and the message after exiting link to these instructions, for users whose package manager has an older version, or whose lazygit is in a folder that they can't write to. Released versions keep linking to them, so give the section an explicit anchor that doesn't change if someone edits the heading. The instructions for Debian and Ubuntu installed lazygit into /usr/local/bin with sudo. lazygit can't update itself there, so install it into ~/.local/bin instead. Also use the lowercase OS name in the archive's name; it only worked because GitHub matches asset names case-insensitively. Co-Authored-By: Claude Opus 5.5 --- README.md | 22 +++++++++++++++++++--- 1 file changed, 19 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index ef7ac0c4a..180139eec 100644 --- a/README.md +++ b/README.md @@ -243,9 +243,23 @@ In the branches panel, lazygit can show which of your branches have an associate _Most of the above packages are maintained by third parties so be sure to vet them yourself and confirm that the maintainer is a trustworthy looking person who attends local sports games and gives back to their communities with barbeque fundraisers etc_ + + + ### Binary Releases -For Windows, Mac OS(10.12+) or Linux, you can download a binary release [here](../../releases). +For Windows, macOS (10.12+), Linux or FreeBSD, you can download a binary release [here](../../releases). + +If you install it in a folder that you can write to, lazygit keeps itself up to date. It checks for a new release once a day and offers to install it. This is also a good way to get the latest version if your package manager has an older one; uninstall it there first. + +On macOS, Linux and FreeBSD, extract `lazygit` from the archive for your platform into a folder that is on your PATH, e.g. `~/.local/bin`: + +```sh +mkdir -p ~/.local/bin +tar -xzf lazygit_*_linux_x86_64.tar.gz -C ~/.local/bin lazygit +``` + +On Windows, extract `lazygit.exe` from the zip archive for your platform into a folder such as `%LOCALAPPDATA%\Programs\lazygit`, and add that folder to your PATH. ### Dev container feature @@ -358,11 +372,13 @@ For **Debian 12 "Bookworm", Ubuntu 25.04 "Plucky Puffin"** and earlier: ```sh LAZYGIT_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazygit/releases/latest" | \grep -Po '"tag_name": *"v\K[^"]*') LAZYGIT_ARCH=$(uname -m | sed -e 's/aarch64/arm64/') -curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/download/v${LAZYGIT_VERSION}/lazygit_${LAZYGIT_VERSION}_Linux_${LAZYGIT_ARCH}.tar.gz" +curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/download/v${LAZYGIT_VERSION}/lazygit_${LAZYGIT_VERSION}_linux_${LAZYGIT_ARCH}.tar.gz" tar xf lazygit.tar.gz lazygit -sudo install lazygit -D -t /usr/local/bin/ +install lazygit -D -t ~/.local/bin/ ``` +This installs lazygit into `~/.local/bin`, so that it can keep itself up to date. On Debian and Ubuntu, the default `~/.profile` adds this folder to your PATH if it exists when you log in. + Verify the correct installation of lazygit: ```sh