Flatpak applications

Ironforge hosts its own repository but it rely on Flathub for most applications as long as they can run without modification on Ironforge.

Add the Flathub repository:

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Add the IronForge flatpak repository:

flatpak remote-add --if-not-exists ironforge https://cdn.ironforge.sh/repo/ironforge.flatpakrepo

Tested Flathub 3rd party applications

The following applications from Flathub works out of the box on IronForge:

  • com.github.tchx84.Flatseal
  • org.mozilla.firefox
  • com.obsproject.Studio
  • org.telegram.desktop

Self-hosted 3rd party application

The following applications are designed to run without any needed modifications to the defaults.

Configuration is stored in ~/.var/app/{app-id} as by Flatpak default.

  • sh.ironforge.cursor
  • sh.ironforge.minecraft
  • sh.ironforge.swaync
  • sh.ironforge.waybar

TODO:

  • sh.ironforge.chrome

For now use the workaround described below.

Upstream issues

  • Add the ability to make 'extra-args' as passed to flatpak run permanent #2913

The workaround for this is to self-host packages. We cannot rely on Flathub for packaging all of our needs anyways so this is not a big issue for us at all at this point.

Running Google Chrome

Google Chrome will by default try and use Xorg and not Wayland. It will also refuse to start as root.

flatpak run com.google.Chrome --no-sandbox --enable-features=UseOzonePlatform --ozone-platform=wayland

Running Minecraft with Flatpak and Gamescope on Wayland

UPDATE(2025 March): This workaround as been integrated into sh.ironforge.minecraft.

Prerequisites

Due to Ironforges lack of XWayland support, additional steps are necessary to enable Java Minecraft to function properly. This guide outlines the required setup.

Step 1: Install Gamescope

Download and install Gamescope using the following command:

flatpak install org.freedesktop.Platform.VulkanLayer.gamescope

Step 2: Install Minecraft

Next, install Minecraft using Flatpak:

flatpak install com.mojang.Minecraft

Step 3: Wrapping Minecraft with Gamescope

Gamescope is installed as an overlay to the Platform SDK. To run Minecraft with Gamescope, execute the following command:

flatpak run \
  --command=/usr/lib/extensions/vulkan/gamescope/bin/gamescope \
  --env=MESA_GL_VERSION_OVERRIDE=4.5COMPAT \
  --env=MESA_GLSL_VERSION_OVERRIDE=450 \
  com.mojang.Minecraft -- minecraft

Notes

  • The MESA_GL_VERSION_OVERRIDE environment variable is required to ensure compatibility and allow the game to start.
  • The 'MESA_GLSL_VERSION_OVERRIDE' might not be strictly required, but it is often recommended in conjunction with the previous override.
  • This issue is not expected to be resolved by Ironforge or Mojang. For additional context, refer to Optifine Issue #420.
  • Gamescope is known to often crash as the launcher software closes, and the main game starts. This can be resolved by opening Settings in the launcher and enabling "Keep the Launcher open while games are running."