Deadlock Mod Manager
Using Mod Manager

Installation Guide

How to download and install Deadlock Mod Manager on your system

Deadlock Mod Manager is available for Windows and Linux. Choose your preferred installation method below.

Watch out for lookalike sites

Only download Deadlock Mod Manager through the options on this page. We don't run deadlockmodmanager.com, deadlockmodmanager.org or deadlockmodmanager.net. They use our name, and some host installers on their own servers that could be swapped at any time.

Installation Process

Download Options

The easiest way to install Deadlock Mod Manager is to download the latest release directly from our website:

Download Deadlock Mod Manager

Option 2: Github Releases

Github Releases

  1. Visit the releases page
  2. Download the appropriate installer for your operating system
  3. Run the installer and follow the setup instructions

CEF (Chromium) Builds

Releases include builds using Chromium Embedded Framework (CEF) instead of the system webview. These assets have a -cef suffix: -cef-setup.exe, -cef.deb, and deadlock-mod-manager-cef.flatpak. On Ubuntu/Debian, the CEF build is also available from the APT repository, and on NixOS as the deadlock-mod-manager-cef package.

On Linux, the CEF build is the default. The download buttons on deadlockmods.app give you the CEF Flatpak, because the system webview (WebKitGTK) is slow or renders blank on many setups. The system webview builds (deadlock-mod-manager.flatpak, .deb, .rpm) are still available as alternatives. There is no CEF .rpm; use the CEF Flatpak on Fedora and openSUSE.

On Windows, the system webview build stays the default and the CEF installer is optional. The CEF download is larger.

Both runtimes have the same manager features. If one renders badly on your system, try the other. Avoid running multiple builds against the same game installation at once.

Windows standalone executable

Download Deadlock.Mod.Manager_<version>_x64-portable.exe from GitHub Releases and run it directly without installing DMM. Stable, nightly, and test releases include this download alongside the installer.

The standalone executable uses the same default AppData locations as the installed app, including existing settings and downloaded mods. Microsoft Edge WebView2 Runtime must already be installed.

To keep using DMM without installation, download the newer standalone executable and replace the old one after closing DMM. The in-app updater uses the Windows installer. Running DMM also registers its deep-link protocols, so keep the executable at a stable location for browser install links.

Option 3: Package Managers

For users who prefer package managers, Deadlock Mod Manager is available through several official repositories:

Windows (winget)

Winget

Pushing new versions to winget is a work in progress. Microsoft takes a while to approve new versions.

winget install --id=Stormix.DeadlockModManager

Ubuntu/Debian (APT)

The repository has two builds: the regular build, which uses the system webview, and the CEF build, which bundles Chromium. If the regular build feels slow, use the CEF build; Chromium generally performs better.

# Add the repository signing key
curl -fsSL https://apt.deadlockmods.app/key.gpg \
  | sudo tee /usr/share/keyrings/deadlock-mod-manager.gpg > /dev/null

# Add the repository
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/deadlock-mod-manager.gpg] https://apt.deadlockmods.app stable main" \
  | sudo tee /etc/apt/sources.list.d/deadlock-mod-manager.list

# Install
sudo apt update
sudo apt install deadlock-mod-manager
# Add the repository signing key
curl -fsSL https://apt.deadlockmods.app/key.gpg \
  | sudo tee /usr/share/keyrings/deadlock-mod-manager.gpg > /dev/null

# Add the repository (cef instead of main)
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/deadlock-mod-manager.gpg] https://apt.deadlockmods.app stable cef" \
  | sudo tee /etc/apt/sources.list.d/deadlock-mod-manager.list

# Install
sudo apt update
sudo apt install deadlock-mod-manager

New stable releases arrive through sudo apt update && sudo apt upgrade. The repository only contains stable x86_64 builds; nightly builds remain available from GitHub Releases.

Both builds install the same deadlock-mod-manager package, chosen by the last word of the repository line, so enable only one of main or cef. To switch builds later, run the "Add the repository" command for the other build, then reinstall:

sudo apt update
sudo apt install --reinstall deadlock-mod-manager

Supported versions

Packages are built on Ubuntu 24.04. Older releases such as Ubuntu 22.04 or Debian 12 may install the package but fail to start because of older system libraries.

Arch Linux (AUR)

# Latest stable release
yay -S deadlock-modmanager

# Latest development build
yay -S deadlock-modmanager-git

nixpkgs

nixpkgs has two packages: deadlock-mod-manager uses the system webview (WebKitGTK), and deadlock-mod-manager-cef bundles Chromium. If the regular package is slow or renders blank, use the CEF one. New versions land in nixos-unstable first. Stable NixOS releases don't receive new packages, so deadlock-mod-manager-cef is missing from NixOS 26.05 and older; take it from nixos-unstable instead.

# Run in your shell
nix-shell -p deadlock-mod-manager --run deadlock-mod-manager

# Experimental nix flakes version
nix shell nixpkgs#deadlock-mod-manager -c deadlock-mod-manager

# CEF (Chromium) build from nixos-unstable
nix shell github:NixOS/nixpkgs/nixos-unstable#deadlock-mod-manager-cef -c deadlock-mod-manager
# configuration.nix (use deadlock-mod-manager-cef for the CEF build)
environment.systemPackages = with pkgs; [
  deadlock-mod-manager
];

Nix nightly

The repository flake builds the latest development version from main. CI publishes each build to the deadlock-mod-manager Cachix cache, so you download it instead of compiling it.

# Trust the cache once (needs root or a trusted Nix user)
cachix use deadlock-mod-manager

# Run the nightly build
nix run github:deadlock-mod-manager/deadlock-mod-manager#nightly

On NixOS, add the cache to your system configuration instead:

# configuration.nix
nix.settings = {
  substituters = [ "https://deadlock-mod-manager.cachix.org" ];
  trusted-public-keys = [
    "deadlock-mod-manager.cachix.org-1:wUjtzL6yN2i9zTq1YrXHBr0mx3LP7tBGsosk3N+/A/M="
  ];
};

Without the cache, Nix builds the app from source, which takes a while.

Gentoo

Available via the third-party ::deftera overlay.

# Enable the overlay
sudo eselect repository add deftera git https://github.com/Deftera186/deftera-overlay.git
sudo emaint sync --repo deftera

# Prebuilt binary (recommended)
sudo emerge -av games-util/deadlock-modmanager-bin

# Or build from source
sudo emerge -av games-util/deadlock-modmanager

More package managers will be added in the future. If you would like to maintain a package manager for Deadlock Mod Manager, please contact us on Discord.

Platform-Specific Installation

Windows Installation

  1. Download the installer (.exe file) from the releases page
  2. Run the installer by double-clicking the downloaded file

Windows Security Warning

You might see a prompt saying "Windows has protected your PC" due to the app not being code-signed yet. Click More Info and then Run Anyway to proceed with the installation.

  1. Follow the setup wizard to choose installation location and options
  2. Launch the application from the Start Menu or desktop shortcut

Linux Installation

Linux Support - Limited

Linux support is provided on a best-effort basis. Due to a lack of contributors with Linux expertise and the maintainer's limited experience distributing software across the many Linux distributions, you may encounter packaging issues, missing dependencies, or platform-specific bugs.

If you're a Linux user and want to help improve support, contributions are very welcome! Please reach out on Discord or open a PR on GitHub.

Ubuntu/Debian (.deb package)

To receive updates through apt, use the APT repository instead.

# Download the .deb file, then install
sudo apt install ./Deadlock.Mod.Manager_*_amd64.deb

Flatpak

There are two Flatpak bundles. deadlock-mod-manager-cef.flatpak (Chromium) is the recommended one; deadlock-mod-manager.flatpak uses the system webview. Both install as dev.stormix.deadlock-mod-manager, so installing one replaces the other.

# Install the recommended CEF (Chromium) bundle
flatpak install ./deadlock-mod-manager-cef.flatpak

# Or the system webview bundle
flatpak install ./deadlock-mod-manager.flatpak

# Or, once published on Flathub:
flatpak install flathub dev.stormix.deadlock-mod-manager

On Steam Deck or other Linux systems, if the Flatpak crashes when you select the game folder, see community-reported Flatpak filesystem workaround.

Arch Linux (AUR)

# Using yay (recommended)
yay -S deadlock-modmanager

# Or using makepkg directly
git clone https://aur.archlinux.org/deadlock-modmanager.git
cd deadlock-modmanager
makepkg -si

Linux Compatibility Note

If the Flatpak application opens to a grey or blank screen, particularly with an NVIDIA GPU, follow the community-reported Flatpak rendering workaround. Automatic GPU detection may fail inside the Flatpak sandbox.

For non-Flatpak installs (.deb / AUR / RPM), you can apply it manually:

WEBKIT_DISABLE_DMABUF_RENDERER=1 deadlock-mod-manager

AUR users have this automatically handled via the .desktop file.

Post-Installation Setup

After installing Deadlock Mod Manager, you'll need to complete the initial setup:

First Launch

  1. Launch the application from your desktop or applications menu
  2. Grant necessary permissions when prompted (file system access for mod installation)
  3. The app will attempt to automatically detect your Deadlock installation

Verify Installation

To ensure everything is working correctly:

First Launch

  1. Check the bottom status bar - API should be online (green) and the game should be "ready".
  2. Browse the Mods tab - you should see available mods loading
  3. Test downloading a mod - try installing a simple mod to verify functionality

Troubleshooting Installation Issues

Common Issues

"App won't start" or crashes on launch

  • Windows: Run as administrator once, then normally
  • Windows, closes instantly with no window: Check for an OPENSSL_ia32cap environment variable. See Windows: App Closes Instantly on Launch
  • Linux: Ensure all dependencies are installed (sudo apt install libwebkit2gtk-4.0-dev on Ubuntu)

"Cannot find Deadlock installation"

  • Verify Deadlock is installed through Steam
  • Check that the game has been launched at least once
  • If the game is still not detected, please open an issue on GitHub with your system info and the steps you took to install the game.

Download/installation issues

  • Check your internet connection

  • Verify you have write permissions to the Deadlock directory

  • Try running the app as administrator (Windows) or with sudo (Linux)

    Region-Specific Issues

    Users in certain regions (Brazil, China, Iran, Russia, Turkey, Ukraine) may need to use a VPN to access mod downloads due to upstream provider restrictions from sites like GameBanana

Getting Help

If you encounter issues not covered here:

  1. Check existing issues on GitHub Issues
  2. Join our Discord for community support: Discord Server
  3. Create a new issue with details about your system and the problem

Security & Safety

Deadlock Mod Manager is open source, and its code is on GitHub. Download it only from the sources listed on this page. You can also scan downloads with VirusTotal.

Next Steps

Once you have successfully installed Deadlock Mod Manager:

On this page