Installing WineHQ packages
The WineHQ repository key was changed on 2018-12-19. If you downloaded and added the key before that time, you will need to download and add the new key and run sudo apt update to accept the repository changes.
The WineHQ packages for Debian 10 and later require libfaudio0 as a dependency. Since the distro does not provide it for Debian 10, users of that version can download libfaudio0 packages from the OBS. See https://forum.winehq.org/viewtopic.php?f=8&t=32192 for details.
Apt-key is now deprecated.
If you get a warning about this, remove the key with
sudo apt-key del <keyid>.
apt-key list to find the <keyid>. And remove the the line about the WineHQ repository from /etc/apt/sources.list(.d/).
Raspbian users: the WineHQ packages are for x86 architecture only; they cannot be installed on an ARM system.
Enable 32 bit packages (if you haven't already):
sudo dpkg --add-architecture i386
Download and install the repository key:
wget -nc https://dl.winehq.org/wine-builds/winehq.key sudo mv winehq.key /usr/share/keyrings/winehq-archive.key
Download and install the WineHQ sources file:
|For this version:||Use this command:|
|Debian 10 (Buster)||
wget -nc https://dl.winehq.org/wine-builds/debian/dists/buster/winehq-buster.sources sudo mv winehq-buster.sources /etc/apt/sources.list.d/
|Debian 11 (Bullseye)||
wget -nc https://dl.winehq.org/wine-builds/debian/dists/bullseye/winehq-bullseye.sources sudo mv winehq-bullseye.sources /etc/apt/sources.list.d/
|Debian Testing (Bookworm)||
wget -nc https://dl.winehq.org/wine-builds/debian/dists/bookworm/winehq-bookworm.sources sudo mv winehq-bookworm.sources /etc/apt/sources.list.d/
sudo apt update
Then install one of the following packages:
sudo apt install --install-recommends winehq-stable
sudo apt install --install-recommends winehq-devel
sudo apt install --install-recommends winehq-staging
If apt complains about missing dependencies, install them, then repeat the last two steps (update and install).
Some notes on the WineHQ packages:
- Files are installed to /opt/wine-devel or /opt/wine-staging.
- Menu items are not created for Wine's builtin programs (winecfg, etc.), and if you are upgrading from a distro package that had added them, they will be removed. You can recreate them yourself using your menu editor.
- WineHQ does not at present package wine-gecko or wine-mono. When creating a new wine prefix, you will be asked if you want to download those components. For best compatibility, it is recommended to click Yes here. If the download doesn't work for you, please follow the instructions on the Gecko and Mono wiki pages to install them manually.
- Beginning with Wine 5.7, the WineHQ Debian packages have an optional debconf setting to enable CAP_NET_RAW to allow applications that need to send and receive raw IP packets to do so. This is disabled by default because it carries a potential security risk, and the vast majority of applications do not need that capability. Users of applications that do need it can enable CAP_NET_RAW after installing Wine by running
dpkg-reconfigure wine-<branch>-amd64 wine-<branch> wine-<branch>-i386
and answering yes to the three questions. (Substitute devel, staging, or stable for <branch> in the above command.)
Building a Source Package
Beginning with 4.0-rc2, the WineHQ repository includes the .dsc, .diff.gz, and .orig.tar.gz files generated by the OBS. These source packages can be found in the /main/source subdirectory of your version's repository (e.g., buster).
Debian's implementation of Multiarch is still incomplete, so for now you can't simply install 32-bit and 64-bit libraries alongside each other. If you're on a 64-bit system, you'll have to create an isolated environment for installing and building with 32-bit dependencies. See Building Wine for instructions on how to build in a chroot or container.
- Official WineHQ download site for Debian.
- WineHQ Debian/Ubuntu package build scripts and logs
- The Debian Wiki's page for Wine.
- Building Wine