Repository files navigation

GitHub Desktop is an open-sourceElectron-basedGitHub app. It is written inTypeScript andusesReact.

This repository contains specific patches on top of the upstreamdesktop/desktop repository to support Linux usage.

It also publishesreleases for various Linux distributions:

• AppImage (.AppImage)
• Debian (.deb)
• RPM (.rpm)

You can use your operating system's package manager to installgithub-desktop andkeep it up to date on Debian and RPM-based distributions.

There are two APT package feeds available, both hosted in the US. You only needto add one or the other here, as both of these are generated based on thereleases from this repository.

wget -qO - https://apt.packages.shiftkey.dev/gpg.key| gpg --dearmor| sudo tee /usr/share/keyrings/shiftkey-packages.gpg> /dev/nullsudo sh -c'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/shiftkey-packages.gpg] https://apt.packages.shiftkey.dev/ubuntu/ any main" > /etc/apt/sources.list.d/shiftkey-packages.list'

wget -qO - https://mirror.mwt.me/shiftkey-desktop/gpgkey| gpg --dearmor| sudo tee /usr/share/keyrings/mwt-desktop.gpg> /dev/nullsudo sh -c'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/mwt-desktop.gpg] https://mirror.mwt.me/shiftkey-desktop/deb/ any main" > /etc/apt/sources.list.d/mwt-desktop.list'

Once you have a feed configured, run this command to install the application:

sudo apt update&& sudo apt install github-desktop

There are two RPM package feeds available, both hosted in the US. You only needto add one or the other here, as both of these are generated based on thereleases from this repository.

sudo rpm --import https://rpm.packages.shiftkey.dev/gpg.keysudo sh -c'echo -e "[shiftkey-packages]\nname=GitHub Desktop\nbaseurl=https://rpm.packages.shiftkey.dev/rpm/\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://rpm.packages.shiftkey.dev/gpg.key" > /etc/yum.repos.d/shiftkey-packages.repo'

sudo rpm --import https://mirror.mwt.me/shiftkey-desktop/gpgkeysudo sh -c'echo -e "[mwt-packages]\nname=GitHub Desktop\nbaseurl=https://mirror.mwt.me/shiftkey-desktop/rpm\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://mirror.mwt.me/shiftkey-desktop/gpgkey" > /etc/yum.repos.d/mwt-packages.repo'

Once you have a feed configured, run this command to install the application:

# if yum is your package managersudo yum install github-desktop# if dnf is your package managersudo dnf install github-desktop# if zypper is your package managersudo zypper ref&& sudo zypperin github-desktop

There are two RPM package feeds available, both hosted in the US. You only needto add one or the other here, as both of these are generated based on thereleases from this repository.

sudo rpm --import https://rpm.packages.shiftkey.dev/gpg.keysudo sh -c'echo -e "[shiftkey-packages]\nname=GitHub Desktop\nbaseurl=https://rpm.packages.shiftkey.dev/rpm/\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://rpm.packages.shiftkey.dev/gpg.key" > /etc/zypp/repos.d/shiftkey-packages.repo'

sudo rpm --import https://mirror.mwt.me/shiftkey-desktop/gpgkeysudo sh -c'echo -e "[mwt-packages]\nname=GitHub Desktop\nbaseurl=https://mirror.mwt.me/shiftkey-desktop/rpm\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://mirror.mwt.me/shiftkey-desktop/gpgkey" > /etc/zypp/repos.d/mwt-packages.repo'

sudo zypper ref&& sudo zypperin github-desktop

Arch Linux users can install GitHub Desktop from theAUR.

gnome-keyring is required and the daemon must be launched either at login or when the X server is started. Normally this is handled by a display manager, but in other cases following the instructions found on theArch Wiki will fix the issue of not being able to save login credentials.

GitHub Desktop is also available cross-platform as aFlatpak andAppImage.

Debian/Ubuntu users can also install directly from this repository usingdeb-get:deb-get install github-desktop.

If you're having troubles with Desktop, please refer to theKnown issuesdocument for guidance and workarounds for common limitations.

If your package manager is still trying to reach PackageCloud, refer to thecleanup instructionsfor details about migrating away.

Please check out theREADMEon the upstreamGitHub Desktop project anddesktop.github.com for more product-orientedinformation about GitHub Desktop.

See ourgetting started documentation for more information on how to set up, authenticate, and configure GitHub Desktop.

MIT

The MIT license grant is not for GitHub's trademarks, which include the logodesigns. GitHub reserves all trademark and copyright rights in and to allGitHub trademarks. GitHub's logos include, for instance, the stylizedInvertocat designs that include "logo" in the file title in the followingfolder:logos.

GitHub® and its stylized versions and the Invertocat mark are GitHub'sTrademarks or registered Trademarks. When using GitHub's logos, be sure tofollow the GitHublogo guidelines.