GitHub Desktop on Gentoo
Full accordion view with installation methods and post-install setupGitHub Desktop is not officially distributed for Linux by GitHub, so on Gentoo the practical route is to use the maintained Linux fork or a packaged community build. The most reliable approach for most users is Flatpak because it avoids a long native dependency chain and keeps updates simple.
If you prefer a more native workflow, you can also build from source using Node.js and Yarn. For a quick portable launch without full installation, you can use an AppImage when available.
sudo emerge --ask sys-apps/flatpak
flatpak remote-add --if-not-exists flathub \
https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub io.github.shiftey.DesktopAfter installation, launch it with:
flatpak run io.github.shiftey.DesktopThis method is the easiest to maintain on Gentoo and usually avoids package conflicts.
sudo emerge --ask dev-vcs/git dev-lang/nodejs sys-devel/yarn
git clone https://github.com/shiftkey/desktop.git
cd desktop
yarn install
yarn build
yarn startThis path gives you a more native development-oriented setup, but it pulls in more dependencies and is more likely to expose Node or Electron version issues if your system is already in a mixed state.
Use this if you want to patch, modify, or directly track the Linux fork source.
Before using GitHub Desktop, make sure your Git identity is configured:
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global user.name
git config --global user.emailYou can also set your default editor and merge tool later if needed. The desktop client will use your existing Git configuration automatically.
If you want a desktop launcher for the Flatpak version, create a shortcut or pin the installed app from your application menu. If the menu entry does not appear immediately, refresh your desktop cache or log out and back in.
flatpak list | grep -i desktop
flatpak run io.github.shiftey.DesktopOn Plasma, once the application launches correctly, right-click the running icon and pin it to the task manager.
Flatpak command not found: install Flatpak first with Portage.
App does not launch: test from terminal and capture errors.
Git identity missing: configure user.name and user.email.
Node conflicts during native build: prefer Flatpak unless you specifically need the source build.
flatpak run io.github.shiftey.Desktop
git --version
node --version
yarn --versionFor Gentoo, the Flatpak path is usually the least painful and the quickest to get stable.
