How to Install Wine (WineHQ) on Pop!_OS 22.04/20.04

Wine is a software application that translates Windows system calls into POSIX-compliant functions. This allows users to run Windows applications on POSIX-compliant operating systems, such as Linux, BSD, and macOS. Wine is not an emulator and does not require a copy of Windows to be installed. Instead, it uses its own set of libraries to provide the necessary functionality. Wine is open-source software released under the GNU Lesser General Public License (LGPL). The following tutorial will show you how to install the latest version using the command line terminal.

The following tutorial will demonstrate how to import the WineHQ apt repository and install Wine Pop!_OS 22.04 or 20.04 LTS using cli commands.

Recommended Steps Before Installation

Before proceeding with the tutorial, ensuring your system is up-to-date with all existing packages is good.

sudo apt update

Optionally, you can list the updates for users who require review or are curious.

sudo apt --list upgradable

Proceed to upgrade any outdated packages using the following command.

sudo apt upgrade

Install Required Packages

The following packages must be installed to assist in installing the software.

sudo apt install dirmngr ca-certificates software-properties-common gnupg gnupg2 apt-transport-https curl -y

These are the most common software packages found on nearly all Linux distributions.

Enable 32-bit Support

Ideally, you should enable 32-bit architecture support, as many games and especially Windows applications may come in this form. Without it, you may be limited in what you can use with Wine.

sudo dpkg --add-architecture i386

Most users should enable this for lower-end systems that can only play lower-end games that come in 32bit format more often than not, and high-powered systems will not notice any impact having the packages installed.

Import WineHQ GPG Key & Repository

Before installing any versions of Wine from WineHQ, import the GPG key and the WineHQ from the Focal Fossa repository branch using the following steps.

First, import the GPG key required to verify the authenticity of the Wine packages from WineHQ.

curl -fsSL | gpg --dearmor | sudo tee /usr/share/keyrings/winehq.gpg > /dev/null

Using the following command, import the WineHQ repository. Please note you will need to match it to the Pop!_OS version you have installed, failure to do this will result in installation issues.

Import command for 22.04:

echo deb [signed-by=/usr/share/keyrings/winehq.gpg] jammy main | sudo tee /etc/apt/sources.list.d/winehq.list

Import command for 20.04:

echo deb [signed-by=/usr/share/keyrings/winehq.gpg] focal main | sudo tee /etc/apt/sources.list.d/winehq.list

Now, run an APT update to reflect the new packages that have been imported.

sudo apt update

Install Wine – WineHQ Stable Release

The first method is to install the latest Wine version from the stable branch. This is often the best solution as it is more updated than the default repository version while not bleeding-edge, such as the development release from WineHQ.

Run the following command to install the stable Wine release.

Example only for now:

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

Once completed, verify the version you have installed by typing the following command:

wine --version

Alternative – Install Wine from the Default Repository

For users who prefer an older version, you can install this alternative version using one of the following commands.

Install Wine with the default repository 64-bit version only.

sudo apt install wine64 -y

For users that have enabled 32-bit Support, install both architectures as follows.

sudo apt install wine64 wine32 -y

Install Wine – WineHQ Staging Release

The second method is to install the latest Wine version from the staging branch. This ideally is the beta version or testing version just before release. I recommend the staging branch for users who prefer a newer version rather than stable without risking the instability risks of bleeding-edge, such as the development version.

Run the following command to install the Wine staging release.

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

Once completed, verify the version you have installed by typing the following command to give you an output.

wine --version

Install Wine – WineHQ Development Release

The third method is to install the latest Wine version from the development branch. This is bleeding-edge software and can sometimes be unstable or cause your system instability. This is recommended for more experienced users or developers that want a taste of what is to come.

With stable, run the following command to install the Wine development release.

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

Once completed, verify the version you have installed by typing the following command to give you an output.

wine --version

How to Finalize Wine Installation

Once WineHQ is installed, run the command winecfg” from your terminal, which will install the required environments for Wine to operate.


Example output:

install mono for wine on pop!_os

Press Install to proceed

How to Configure Wine

Once you have finished the installation, the Wine configuration dialogue will be shown. In this section of the software, you can configure various Wine settings. The default settings should be sufficient in most cases. However, if you change anything, the Windows version will default from Windows 7 to something more recent, such as Windows 10. Still, as of now, Windows 11 is not supported, given it has just been released.


example changing window versions for wine on pop!_os

Once finished, close the dialogue box.

Now, downloading any .exe Windows binary file that suits your configuration, you can run it by right-clicking, selecting “Open With Other Application,” and selecting Wine to run.


example opening executable binary with wine on pop!_os

The example above downloaded Notepad++ and opened the installation .exe using Wine.

Proceed to install, then run your Windows application, the final look of installing Notepad++ on your desktop.


example notepad++ install with wine on pop!_os


example completion of notepad++ install with wine on pop!_os

How to Run Wine From Terminal

While you can right-click applications downloaded and select open with Wine, as most users know, you can use the following command for strictly terminal terms.

wine PROGRAM [ARGUMENTS...]   Run the specified program


wine <application name>.exe

How to Update/Upgrade Wine

For future updates from WineHQ, this can be done using the APT update and APT upgrade commands.

sudo apt upgrade && sudo apt update

How to Remove (Uninstall) Wine

Depending on your needs, you may need to remove a particular version of Wine to install another or remove it in full. Use one of the corresponding commands to match your version.

Remove WineHQ Stable Release

sudo apt autoremove winehq-stable -y

Remove WineHQ Staging Release

sudo apt autoremove winehq-staging -y

Remove WineHQ Development Release

sudo apt autoremove winehq-devel -y

For complete removal, delete the repository file.

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

If you have removed the WineHQ repository, it is recommended to remove the GPG key.

sudo rm /usr/share/keyrings/winehq*

Remove Wine (Default version)

The users that installed Wine from the default repository use the following command.

sudo apt autoremove wine32 wine64 -y

Not what you were looking for? Try searching for additional tutorials.

Leave a Comment