Home
How to Install and Run UZDoom on Linux Using AppImage and Flatpak
UZDoom represents the modern evolution of the classic Doom engine, specifically designed to push the boundaries of modding and performance while maintaining high compatibility with the vast history of GZDoom content. For Linux users, UZDoom offers a robust alternative to older source ports, bringing advanced Vulkan and OpenGL rendering capabilities to the open-source desktop environment. This guide provides comprehensive instructions on how to download, install, and configure UZDoom across various Linux distributions, ensuring that the transition from legacy ports is seamless.
Quick Start for UZDoom on Linux
To get UZDoom running on most modern Linux distributions immediately, follow these core steps:
- Obtain the official AppImage from the project's repository.
- Grant the file execution permissions using the terminal command:
chmod +x Linux-UZDoom-x.x.x.AppImage. - Place your game data files (IWADs) in
~/.config/uzdoom/. - Run the AppImage to start the engine.
What is UZDoom and Why Choose It?
UZDoom is a feature-centric source port based on GZDoom. It is maintained by a dedicated group of developers, many of whom were instrumental in the development of GZDoom itself. The project focuses on integrating new features for modders and players while streamlining the code to support modern hardware and APIs.
For Linux users, UZDoom is particularly valuable because it prioritizes compatibility with modern libraries while offering a "Legacy" build for users on older distributions that might lack the latest version of glibc. It supports advanced scripting through ZScript, high-resolution rendering, and a flexible UI that respects Linux desktop standards.
Method 1: Installing via AppImage (The Universal Method)
The AppImage format is the most straightforward way to run UZDoom on Linux because it bundles most required libraries into a single file. This eliminates the "dependency hell" often associated with older software on Linux.
Selecting the Right Version
When visiting the official GitHub releases section, you will typically see two Linux versions:
- Standard AppImage: Targets current distributions like Ubuntu 22.04+, Fedora 38+, and recent Arch Linux releases. It utilizes modern system libraries for optimal performance.
- Legacy AppImage: Specifically designed for older distributions or LTS versions that use an older glibc. If the standard version fails to launch with a "version GLIBC_X.XX not found" error, the Legacy build is the correct choice.
Step-by-Step Deployment
- Download: Move the
.AppImagefile to a dedicated folder, such as~/Games/UZDoom/. - Set Permissions: Open your terminal in that folder and run:
Alternatively, right-click the file in your file manager (Nautilus, Dolphin, or Thunar), go to Properties > Permissions, and check "Allow executing file as program."chmod +x Linux-UZDoom-4.14.3.AppImage - Execution: You can now launch the engine by double-clicking the file or running
./Linux-UZDoom-4.14.3.AppImagein the terminal.
Method 2: Installing via Flatpak (Flathub)
For users who prefer sandboxed applications and easy updates, UZDoom is available on Flathub. This method is ideal for Steam Deck users or those on immutable distros like Fedora Silverblue.
Installation Commands
If you have Flatpak configured on your system, execute the following in your terminal: