Install WineHQ on Ubuntu 22.04 | Easy Steps

This guide on the Orcacore website aims to teach you how to Install WineHQ on Ubuntu 22.04 LTS from the Command Line. We’ll walk through a step-by-step process, ensuring you can run Windows applications on your Ubuntu system with ease. Install WineHQ allows seamless integration.

Wine Is Not an Emulator (Wine) is a compatibility layer that allows you to run Windows executable files on Linux operating systems. It works by translating Windows system calls into POSIX system calls, which are understood by Linux programs. This translation process allows many Windows applications to function correctly, albeit with varying degrees of success and stability, on Linux distributions.

Wine also includes a tool called "Winelib," which facilitates the compilation of Windows-supported applications and programs to port them to Unix-like systems. This makes it easier to adapt Windows software for use in Linux environments.

In simpler terms, Wine is a collection of Linux libraries that bridges the gap between Windows and Linux, enabling many Windows applications to run on Linux distributions with varying degrees of success and stability. Install WineHQ and start running windows programs on Ubuntu.

Steps To Install WineHQ on Ubuntu 22.04 from Terminal

To follow this guide, you’ll need to be logged into your Ubuntu 22.04 server as a non-root user with sudo privileges. If you haven’t already set this up, you can refer to our guide on Initial Server Setup with Ubuntu 22.04 on the Orcacore website.

Step 1. Enable 32-bit architecture on Ubuntu 22.04

First, check the installed architectures using the following command:

sudo dpkg --print-architecture

You should see output similar to this:

amd64

Next, check if a 32-bit architecture is already installed on your system:

sudo dpkg --print-foreign-architectures

Ideally, you should see the following output:

i386

Note: If "i386" is not displayed, execute the following command to add 32-bit architecture support:

sudo dpkg --add-architecture i386

After adding the architecture, re-check:

sudo dpkg --print-foreign-architectures

Step 2. Download and Add WineHQ Repository Key

Now, you need to add the WineHQ repository key to your Ubuntu 22.04 system. Execute the following commands:

sudo mkdir -pm755 /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key

Then, download the WineHQ sources file:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources

Update your local package index:

sudo apt update

Important Note: If you encounter a GPG error similar to "W: GPG error: https://dl.winehq.org/ …", you need to edit the winehq-<distro>.sources file and replace /usr/share/keyrings/ with /etc/apt/keyrings/.

In this case, use the following command:

sudo sed -i s@/usr/share/keyrings/@/etc/apt/keyrings/@ /etc/apt/sources.list.d/winehq-jammy.sources

Now, proceed to the next step to install Wine on Ubuntu 22.04.

Step 3. Install Wine on Ubuntu 22.04

At this point, you can install WineHQ using one of the following commands, depending on the branch you prefer:

1. WineHQ Stable branch:

sudo apt install --install-recommends winehq-stable -y

2. WineHQ Development branch:

sudo apt install --install-recommends winehq-devel -y

3. WineHQ Staging branch:

sudo apt install --install-recommends winehq-staging -y

It is generally recommended to install the stable branch for most users. After the installation is complete, verify it by checking the Wine version:

wine --version

This should produce output similar to:

wine-8.0.2

Step 4. Uninstall or Remove Wine from Ubuntu 22.04 LTS

If you no longer need Wine, you can easily remove it from your server. Run the following command:

sudo apt autoremove --install-recommends winehq-stable --purge

Note: If you installed Wine Development or Wine Staging, replace winehq-stable with either winehq-devel or winehq-staging accordingly.

For complete removal, delete the repository file:

sudo rm /etc/apt/sources.list.d/winehq*

If you removed the WineHQ repository, it’s also recommended to remove the GPG key:

sudo rm /etc/apt/keyrings/winehq*

Conclusion

You’ve now learned how to Install WineHQ (Wine) on Ubuntu 22.04 LTS. You can easily add the Wine repository to your server and install the stable version.

You might also find these articles helpful:

• Install and Configure Fail2ban on Ubuntu 22.04
• Install chkrootkit on Ubuntu 22.04
• Installing FastAPI with MongoDB on Ubuntu 24.04
• Ubuntu 25.04 Plucky Puffin with Better Performance

Alternative Solutions to Running Windows Applications on Ubuntu 22.04

While Wine is a popular and powerful tool, other methods exist for running Windows applications on Ubuntu. Here are two alternative solutions:

1. Using Virtual Machines (e.g., VirtualBox)

Virtual machines provide a complete virtualization of an operating system. This means you can install a full version of Windows within your Ubuntu environment and run Windows applications as if you were using a native Windows machine.

Explanation:

VirtualBox (or other virtualization software like VMware) creates a virtual environment that mimics a physical computer. You allocate resources (CPU, RAM, storage) from your host machine (Ubuntu) to the virtual machine. Then, you install Windows (or any other OS) onto this virtual machine. The Windows installation operates independently within the virtual machine, allowing you to install and run Windows applications without directly interacting with the Ubuntu system.

Steps:

1. Install VirtualBox:

   sudo apt update
   sudo apt install virtualbox virtualbox-ext-pack

2. Download a Windows ISO: Obtain a Windows ISO file from Microsoft (you may need a valid Windows license).

3. Create a New Virtual Machine: Open VirtualBox and create a new virtual machine, specifying the amount of RAM, storage, and other resources.

4. Install Windows: Boot the virtual machine from the Windows ISO file and follow the Windows installation process.

5. Install Guest Additions: Once Windows is installed, install the VirtualBox Guest Additions to improve performance and integration between the host (Ubuntu) and guest (Windows) operating systems. This can be done from the VirtualBox menu, Devices -> Insert Guest Additions CD image.

Advantages:

• High Compatibility: Virtual machines offer better compatibility with Windows applications since they run a complete Windows operating system.
• Isolation: Applications run in an isolated environment, preventing potential conflicts with the host Ubuntu system.
• Flexibility: You can install multiple versions of Windows or other operating systems within different virtual machines.

Disadvantages:

• Resource Intensive: Running a virtual machine requires significant system resources (CPU, RAM, storage), which can impact performance, especially on older hardware.
• Complexity: Setting up and managing a virtual machine can be more complex than using Wine.
• Overhead: There’s performance overhead due to the virtualization layer.

2. Using Containerization with Docker and Wine

Docker allows you to package an application with all of its dependencies into a standardized unit for software development. While Docker primarily targets Linux-based applications, it can be combined with Wine to run Windows applications within a containerized environment on Ubuntu.

Explanation:

This approach involves creating a Docker image that contains Wine and any necessary Windows dependencies. The Windows application is then executed within the Docker container, leveraging Wine to translate system calls.

Steps:

1. Install Docker:

   sudo apt update
   sudo apt install docker.io
   sudo systemctl start docker
   sudo systemctl enable docker

2. Create a Dockerfile: Create a Dockerfile that defines the steps to build the Docker image. Here’s an example:

   FROM ubuntu:latest
   
   RUN apt-get update && apt-get install -y wine
   
   # Copy the Windows application into the container
   COPY myapp.exe /app/
   
   # Set the entry point to run the application with Wine
   CMD wine /app/myapp.exe

   Replace myapp.exe with the actual name of your Windows executable.

3. Build the Docker Image:

   docker build -t wine-app .

   This command builds a Docker image named wine-app from the Dockerfile in the current directory.

4. Run the Docker Container:

   docker run -it --rm -v "$HOME/.wine:/root/.wine" wine-app

   • -it: Runs the container in interactive mode with a pseudo-TTY allocated.
   • --rm: Automatically removes the container when it exits.
   • -v "$HOME/.wine:/root/.wine": Mounts the user’s Wine configuration directory into the container, allowing settings and installed components to be persistent between container runs.

Advantages:

• Isolation: The Windows application runs in an isolated container, preventing conflicts with the host system.
• Reproducibility: Docker ensures that the application runs consistently across different environments.
• Resource Efficiency: Compared to virtual machines, Docker containers typically consume fewer resources.

Disadvantages:

• Complexity: Setting up Docker and creating Dockerfiles requires some technical knowledge.
• Wine Limitations: The compatibility of the Windows application still depends on Wine’s capabilities.
• GUI Issues: Running GUI-based Windows applications within Docker can be challenging and may require additional configuration for X11 forwarding or similar solutions.

Both virtual machines and Docker offer viable alternatives to directly installing Wine on your Ubuntu system. The best choice depends on your specific needs and technical expertise. Virtual machines prioritize compatibility and isolation but are resource-intensive. Docker offers resource efficiency and reproducibility but requires more technical setup and may have limitations with GUI applications. Regardless of the method you choose, running Windows applications on Ubuntu 22.04 is entirely possible.