Skip to content

Getting Started

ry edited this page May 15, 2026 · 13 revisions

Important

Flatpak is the primary supported distribution method for Lumoria.

Lumoria is also available through the AUR, Fedora COPR, and an Ubuntu PPA for users who prefer native distribution packages. These packages are built and published alongside Lumoria releases, but they may occasionally lag behind the Flatpak release or receive less platform-specific troubleshooting.

—ry

Installing from Flathub

Lumoria is available on Flathub and should be readily available on most distributions. See the Flathub setup page for instructions specific to your distribution.

Get it on Flathub

After installation, Lumoria should appear under Games.

Note

SteamOS users: Before launching Lumoria on Steam Deck, see the SteamOS setup guide for additional setup steps.

Manually running from the command line

flatpak run net.windower.Lumoria

Updating Lumoria

Flatpak updates are handled a little differently depending on your Linux distribution and desktop environment. On most systems, Lumoria should update through your normal software center or update tool, such as GNOME Software, KDE Discover, or your distribution's update manager.

If Lumoria does not appear to update automatically, or if you prefer to update it manually, you can run:

flatpak update net.windower.Lumoria

Migrating from the test version

If you were testing the pre-Flathub release version, first of all: thank you!

You will need to uninstall the test version and remove the test repository first:

flatpak remove --user -y net.windower.Lumoria
flatpak remote-delete --user lumoria

Your existing Lumoria data and preferences should be kept.

After that, install Lumoria from Flathub using the instructions above:

Installing from Flathub

There are numerous critical bug fixes (gdiplus issue) and a slew of new features from community requests, so you might find it better to reinstall when migrating to the official release. As always, you can cheat when reinstalling by copying your old prefix data. Just make sure you launch PlayOnline at least once and do it's update. If you don't the game will not launch when you copy your data over.

Otherwise, if you do not want to reinstall, it is highly recommended that you go to Manage Prefix > Packages and reinstall corefonts and gdiplus.

If you are using Windower 4, installing allfonts is not recommended.

Alternative Distribution Packages

Arch Linux / AUR (@rysas):

paru:

paru -S lumoria

yay:

yay -S lumoria

Fedora / COPR (@rysas):

Copr build status

For more information about enabling COPR, visit their documentation.

sudo dnf copr enable rysas/lumoria
sudo dnf install lumoria

Ubuntu / Mint PPA (@rysas):

sudo add-apt-repository ppa:rysas/lumoria
sudo apt update
sudo apt install lumoria

Building from source

See Building for instructions.

Clone this wiki locally