thelinuxvault blog

Install Wine on Manjaro: A Comprehensive Guide

If you’re a Manjaro Linux user who needs to run Windows applications or games, Wine (Wine Is Not an Emulator) is your go-to tool. Wine is a compatibility layer that allows Windows software to run on Unix-like operating systems (including Linux) by translating Windows API calls into native Linux system calls. Unlike emulators, Wine doesn’t virtualize hardware, making it lightweight and efficient.

Manjaro, a user-friendly Arch-based distro, offers multiple ways to install Wine, from official repositories to community-maintained versions. This guide will walk you through every step, from prerequisites to post-installation configuration, ensuring you can run your favorite Windows apps seamlessly on Manjaro.

2026-02

Table of Contents#

  1. Prerequisites
    • 1.1 Check System Architecture
    • 1.2 Update Your System
    • 1.3 Enable Multilib Repository
  2. Installation Methods
    • 2.1 Install Wine from Official Manjaro Repositories (Stable Version)
    • 2.2 Install Wine Staging or Development Versions (AUR)
  3. Post-Installation Configuration
    • 3.1 Set Up Wine Prefix
    • 3.2 Install Optional Dependencies (Mono, Gecko)
    • 3.3 Configure Wine with winecfg
  4. Install Winetricks (Optional but Recommended)
  5. Testing Wine
  6. Troubleshooting Common Issues
  7. Conclusion
  8. References

Prerequisites#

Before installing Wine, ensure your system meets these requirements and is properly configured.

1.1 Check System Architecture#

Wine supports both 64-bit and 32-bit applications. Most modern Manjaro systems are 64-bit, but you’ll need 32-bit libraries for compatibility with 32-bit Windows apps. To confirm your architecture:

uname -m
  • Output x86_64 indicates a 64-bit system (most common).
  • If you see i686, you’re on a 32-bit system (rare today).

1.2 Update Your System#

Always update your system before installing new software to avoid dependency conflicts:

sudo pacman -Syu

Enter your password when prompted. This command updates the package database and upgrades all installed packages.

1.3 Enable Multilib Repository#

The multilib repository contains 32-bit libraries required for running 32-bit Windows apps via Wine. By default, it may be disabled on Manjaro.

Step 1: Edit the Pacman configuration file:

sudo nano /etc/pacman.conf

Step 2: Locate the [multilib] section (usually near the bottom) and uncomment the lines by removing the # symbol:

[multilib]
Include = /etc/pacman.d/mirrorlist

Step 3: Save and exit: Press Ctrl+O to save, Enter to confirm the filename, then Ctrl+X to exit.

Step 4: Refresh the package database to include multilib:

sudo pacman -Sy

Installation Methods#

Manjaro offers multiple Wine versions. Choose the one that best fits your needs:

2.1 Install Wine from Official Manjaro Repositories (Stable Version)#

The official Manjaro repositories include Wine Stable, the recommended version for most users (stable, well-tested, and secure).

Step 1: Install Wine Stable, along with optional but recommended dependencies:

sudo pacman -S wine wine-mono wine-gecko
  • wine: The core Wine package.
  • wine-mono: Open-source implementation of .NET Framework (required for apps using .NET).
  • wine-gecko: Embedded web browser engine (required for HTML-based installers/help files).

Step 2: Confirm the installation by pressing Enter when prompted.

2.2 Install Wine Staging or Development Versions (AUR)#

For advanced users, Wine Staging (with experimental features) or Wine Development (cutting-edge updates) are available via the Arch User Repository (AUR).

2.2.1 Install an AUR Helper (if not already installed)#

AUR helpers like yay simplify installing AUR packages. Install yay first:

sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

2.2.2 Install Wine Staging#

Wine Staging includes patches for better compatibility (e.g., with newer games or apps):

yay -S wine-staging wine-mono wine-gecko

2.2.3 Install Wine Development#

Wine Development is the latest (unstable) version, ideal for testing new features:

yay -S wine-devel wine-mono wine-gecko

Post-Installation Configuration#

After installing Wine, a few tweaks will optimize compatibility.

3.1 Set Up Wine Prefix#

A Wine prefix is a directory (~/.wine by default) that mimics the Windows filesystem (e.g., C:\ drive). The first time you run Wine, it auto-creates this prefix.

Initialize the prefix:

winecfg

A configuration window will appear. Wine will download missing components (if wine-mono/wine-gecko weren’t installed) – follow the prompts.

3.2 Configure Wine with winecfg#

Use winecfg to adjust settings for better app compatibility:

  • Windows Version: Under the "Applications" tab, select a Windows version (e.g., Windows 10) for specific apps.
  • DLL Overrides: Under the "Libraries" tab, override problematic DLLs (e.g., replace mscoree.dll with a native version for .NET apps).
  • Graphics: Adjust screen resolution or enable virtual desktop mode under the "Graphics" tab.

3.3 Create Separate Prefixes (Optional)#

To avoid conflicts between apps, create isolated prefixes (e.g., one for games, one for productivity apps):

WINEPREFIX=~/.wine-work winecfg  # Creates a "work" prefix

Winetricks is a script to install missing Windows libraries (e.g., DirectX, Visual C++ Runtime) and tweak Wine settings.

Install Winetricks#

From official repos (Manjaro Stable/Testing):

sudo pacman -S winetricks

From AUR (if not in repos):

yay -S winetricks

Basic Winetricks Usage#

  • List all available packages: 
    winetricks list-all
  • Install a package (e.g., .NET Framework 4.8): 
    winetricks dotnet48
  • Install fonts (e.g., core Windows fonts): 
    winetricks corefonts

Testing Wine#

Verify Wine works by running a simple Windows app.

Test with Notepad#

Wine includes a Windows Notepad clone. Run it:

wine notepad.exe

If Notepad opens, Wine is working!

Test with a Real App#

Download a small Windows EXE (e.g., 7-Zip) and run it:

wine ~/Downloads/7z2201-x64.exe  # Replace with your EXE path

Follow the installer prompts – the app will install to ~/.wine/drive_c/Program Files/.

Troubleshooting Common Issues#

Missing 32-bit Libraries#

Error: wine: error while loading shared libraries: libxxx.so: cannot open shared object file
Fix: Ensure multilib is enabled (see Prerequisites) and install the missing library (e.g., lib32-libxxx).

App Crashes or Freezes#

  • Use a New Prefix: Isolate the app with a fresh prefix: 
    WINEPREFIX=~/.wine-myapp wine ~/path/to/app.exe
  • Check Logs: Run the app in the terminal to see errors: 
    wine ~/path/to/app.exe 2>&1 | tee wine-log.txt

Poor Performance#

  • Update Graphics Drivers: Install proprietary drivers (e.g., NVIDIA, AMD) for better gaming performance.
  • Disable Desktop Compositor: Temporarily disable Manjaro’s compositor (Settings → Display → Compositor) for games.

Conclusion#

Installing Wine on Manjaro is straightforward with the right steps. Start with the stable version from official repos, enable multilib for 32-bit support, and use winetricks to resolve compatibility issues. Whether you need to run productivity software, games, or legacy apps, Wine bridges the gap between Windows and Manjaro.

References#