How to Set Up Heroic Games Launcher 2.22 on Linux in 2026

If you own a stack of Epic, GOG or Amazon Prime free games but you’ve bounced off the official launchers on Linux, Heroic Games Launcher is the project that fixes that pain. It’s a free, GPL-3.0 alternative launcher that wraps the open-source Legendary (Epic), gogdl (GOG) and Nile (Amazon) command-line clients into one Electron app that runs natively on Linux, Windows, macOS and the Steam Deck.

On 2026-08-14, the project’s maintainer PlayingTux pushed v2.22.1, a hotfix on top of May’s v2.22.0 “Editable Library” release. This guide covers a fresh install on Ubuntu, Fedora, Arch and the Steam Deck, the few settings you actually need to flip on a brand-new install, and the seven failure modes the project keeps flagging on GitHub.

What is Heroic, and why bother?

Heroic’s pitch is simple: the official Epic launcher doesn’t run on Linux at all, and GOG Galaxy is Windows/macOS only. With Heroic you keep one application for everything — Epic freebies, GOG DRM-free titles, Amazon Prime claims — plus a built-in Wine/Proton manager that downloads GE-Proton, Wine-GE and Wine-Lutris for you, so you don’t have to hand-roll a prefix.

The project is healthy: 12,043 stars, 665 forks on GitHub, 20M+ monthly users, ~40 languages and a non-commercial funding model. The README explicitly lists Heroic as the recommended way to install Epic on a Steam Deck.

Three reasons it’s worth trying in 2026:

• Console Mode (added April 2026 in v2.21.0) gives you a full-screen, controller-friendly library that behaves nicely on the Steam Deck’s TV mode and a couch setup.
• Custom artwork integration with SteamGridDB, so imported titles look right.
• A download queue that runs Epic + GOG + Amazon installs back-to-back with live speed/disk readouts.

Install via Flatpak (the recommended path on every distro)

The Heroic team lists Flatpak first because it sandboxes the launcher, hands you automatic updates through Flathub, and behaves identically across distros. Flatpak 1.12+ is the only prerequisite — it’s already installed on SteamOS, Fedora Workstation 39+, Ubuntu 22.04+, current openSUSE, and any Arch derivative.

# 1. Make sure Flathub is wired up
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# 2. Install
flatpak install flathub com.heroicgameslauncher.hgl

# 3. Launch
flatpak run com.heroicgameslauncher.hgl

If you’d rather not use Flatpak, every other install path is documented in the README:

• Debian/Ubuntu: download the .deb from the v2.22.1 release page and sudo dpkg -i Heroic*amd64.deb.
• Arch / Manjaro / EndeavourOS: AUR package heroic-games-launcher-bin.
• Fedora: the .rpm from the release page, then sudo dnf install ./heroic-*.x86_64.rpm.
• NixOS: the heroic (FHS) or heroic-unwrapped (no FHS) packages in nixpkgs.
• Steam Deck: install through Discover in Desktop Mode — that’s the only path Valve officially supports.

First-run checklist: five settings to flip

Most “Heroic doesn’t work” issues trace back to skipping these. Do them in order the first time you open it:

1. Settings → Wine Manager → Download GE-Proton. Heroic falls back to a system Wine build that may be stale if you skip this. Do it before installing your first game.
2. Settings → Default Wine Prefix → pick a folder on a drive with at least your largest game’s worth of free space plus 500 MB.
3. Settings → Library → Custom SteamGridDB art if you import non-store titles (Standalone .exe games, itch.io, etc.).
4. Settings → General → “Show ProtonDB rating on game tiles” so you can see the community’s Linux verdict without leaving the launcher.
5. Settings → Advanced → disable telemetry — analytics are anonymous and off by default, but you’ll see the toggle.

Linking your Epic, GOG and Amazon accounts

Heroic uses each storefront’s official OAuth flow — your password never touches Heroic’s source.

• Epic: click Login in the sidebar, sign in through the browser, paste the returned authorisation code into Heroic. Two-factor authentication works.
• GOG: same flow, browser-based login. Heroic will import your GOG library including cloud saves where the publisher enabled them.
• Amazon: click Login with Amazon. Heroic currently shows Amazon Prime Gaming titles you’ve claimed but not the full Amazon Games client library — that’s by design.

Once linked, all three stores show up in the left sidebar; you can switch between them without restarting.

Installing your first Windows-only game

Most Epic/GOG freebies are Windows binaries. Heroic treats each game as a Wine/Proton prefix on Linux.

1. Pick a game from the library.
2. On the Game Page, choose Install and pick an install path on a drive with enough free space.
3. In Wine version, pick GE-Proton-9-XX (whatever Wine Manager lists as newest).
4. In Wine prefix, point to the default prefix unless you’ve already set one up.
5. Click Install — Heroic writes the prefix, downloads the game and reports progress in the queue.

For most single-player titles (Hades, Celeste, Disco Elysium, Tunic, outer Wilds, Slay the Spire) this is the entire workflow. If the game ships with anti-cheat, ProtonDB will tell you what works before you waste a download:

• Single-player EAC / BattlEye titles — usually work, the developer just has to enable it.
• Multiplayer kernel-level anti-cheat (Vanguard, FACEIT AC) — does not work on Linux at all, regardless of launcher.
• Fortnite — Epic actively blocks Linux. Don’t expect this to change soon.

Steam Deck: the reason most people install Heroic

The Steam Deck’s official SteamOS is locked to the Discover store for third-party launchers, and that’s exactly where Heroic shows up. Install it through Discover in Desktop Mode, then return to Gaming Mode and launch Heroic from the Steam library.

Three Deck-specific settings worth flipping:

• Console Mode (the big TV-shaped icon in the top-right) gives a full-screen, controller-first view.
• In Settings → Wine Manager, pick GE-Proton as default.
• If a game refuses to launch from Gaming Mode, add Heroic to Steam as a non-Steam shortcut and pass the game ID as a launch argument. The project wiki covers the exact command line.

Seven failure modes (and the fix the project keeps recommending)

From the project’s GitHub issues, here are the recurring setup errors that account for ~80% of “Heroic doesn’t work” reports:

1. Installed a Windows game before opening Wine Manager. Fix: open Settings → Wine Manager, install GE-Proton, then reinstall the game.
2. Used Wine-GE for a 2024+ title. Wine-GE stopped receiving updates in 2024. Use GE-Proton for any modern game.
3. Ran Heroic as root. Breaks keyring, corrupts config ownership. Always run as a normal user.
4. Anticheat mismatch. Check ProtonDB before downloading a 60 GB title.
5. Missing Flatpak 1.12+. Older Flatpaks can’t unpack the Heroic bundle. Update flatpak itself.
6. Wrong install path permissions. Pick a folder you own; /opt will bite you.
7. Stale prefix. If a game that worked yesterday now crashes, delete its Wine prefix in the game’s settings and let Heroic regenerate it.

v2.22.1: what changed in the August hotfix

PlayingTux’s v2.22.1 hotfix landed on 2026-08-14 with a small but useful set of fixes on top of May’s v2.22.0:

• Editable game names and cover art for the entire library, not just imported titles.
• Console Mode stability fixes for the Steam Deck after the v2.21.0 rewrite.
• Wine Manager UI refresh that makes it easier to tell GE-Proton from Wine-GE from Wine-Lutris at a glance.
• Several crash fixes around the GOG offline installer path.

The roadmap remains modest: IndieGala support has been “planned” for a while, and a future release will improve the Amazon Prime integration.

Where to learn more

• Project homepage: https://heroicgameslauncher.com/
• GitHub repository: https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher
• Linux quick-start guide: the project’s GitHub wiki has a step-by-step.
• ProtonDB: https://www.protondb.com — always check the rating before downloading a 60 GB title.
• Heroic Discord: the developers and most active users hang out there; it’s the fastest way to file an issue that gets seen.

Heroic is the closest thing Linux has to a unified cross-store launcher that respects your time and your privacy. With v2.22.1 out the door in August 2026 and Console Mode finally usable on the Deck, there’s no reason not to make it your default Epic/GOG/Amazon client.