From WineHQ Wiki
Jump to: navigation, search

Translations of this page: Flag of the People's Republic of China.svg 简体中文

Installing WineHQ packages

Dialog-warning.svg 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.

Dialog-warning.svgBeginning with Wine 4.5, the wine-devel packages for Debian Testing require libfaudio0 as a dependency. Since the distro does not provide it, libfaudio0 packages can be downloaded from the OBS. See for details.

Tango-style info icon.svg 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
sudo apt-key add winehq.key

Add the repository to /etc/apt/sources.list or create a *.list under /etc/apt/sources.list.d/ with the following content:

For this version: Add this content to /etc/apt/sources.list:
Debian 8 (Jessie) deb jessie main
Debian 9 (Stretch) deb stretch main
Debian 10 (currently Testing) (Buster) deb buster main

Update packages:

sudo apt update

Then install one of the following packages:

Stable branch
sudo apt install --install-recommends winehq-stable
Development branch
sudo apt install --install-recommends winehq-devel
Staging branch
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.

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., jessie, stretch, or buster).

Building WoW64

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.

See Also