Difference between revisions of "WineHQ Repository"
| Line 5: | Line 5: | ||
To make installing the latest version of Wine as easy as possible, WineHQ has its own repository. | To make installing the latest version of Wine as easy as possible, WineHQ has its own repository. | ||
Should a newer version of Wine give problems, it is also possible to install an older version of your choice. | Should a newer version of Wine give problems, it is also possible to install an older version of your choice. | ||
| − | |||
== Preperation == | == Preperation == | ||
| Line 14: | Line 13: | ||
sudo mkdir -pm755 /etc/apt/keyrings | sudo mkdir -pm755 /etc/apt/keyrings | ||
sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key | sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key | ||
| − | |||
== Add the repository == | == Add the repository == | ||
| Line 20: | Line 18: | ||
<!-- Collapsible elements, embed the new wiki pages 'ubuntu_versions' and 'debian_versions' --> | <!-- Collapsible elements, embed the new wiki pages 'ubuntu_versions' and 'debian_versions' --> | ||
| + | <span class="mw-customtoggle-ubuntu">Click here for [[File:Icon-distro-ubuntu.png|x20px]] '''<u>Ubuntu/ Linux Mint</u>'''</span> | ||
| − | + | <span class="mw-customtoggle-debian">Click here for [[File:Icon-distro-debian.png|x20px]] '''<u>Debian</u>''' and compatible derivatives</span> | |
| − | |||
| − | <span class="mw-customtoggle-debian">Click here for [[File:Icon-distro-debian.png|x20px]] '''<u>Debian</u>''' and derivatives</span> | ||
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ubuntu">{{:ubuntu_versions}}</div> | <div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-ubuntu">{{:ubuntu_versions}}</div> | ||
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">{{:debian_versions}}</div> | <div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-debian">{{:debian_versions}}</div> | ||
| − | + | ---- | |
| − | |||
Update the package information: | Update the package information: | ||
sudo apt update | sudo apt update | ||
| Line 50: | Line 46: | ||
The [[Wine_User%27s_Guide#Wine_from_WineHQ|WineHQ Wiki]] explains the differences between the branches. | The [[Wine_User%27s_Guide#Wine_from_WineHQ|WineHQ Wiki]] explains the differences between the branches. | ||
| − | |||
== Help == | == Help == | ||
| − | Sometimes there are problems installing Wine. If your problem is not listed, search the [https://forums.winehq.org/WineHQ forum] | + | Sometimes there are problems installing Wine. If your problem is not listed, search the [https://forums.winehq.org/WineHQ forum] or if you can't find an answer ask your question. |
=== Missing dependencies === | === Missing dependencies === | ||
| Line 59: | Line 54: | ||
Using PPAs or third-party repositories may prevent the installation of Wine. | Using PPAs or third-party repositories may prevent the installation of Wine. | ||
Often the problem is that these repositories are not multiarch. The required 32 and 64-bit packages are missing or cannot be installed side by side. | Often the problem is that these repositories are not multiarch. The required 32 and 64-bit packages are missing or cannot be installed side by side. | ||
| − | The deb.sury.org repository is known for causing problems | + | The ''deb.sury.org'' repository is known for causing problems. |
| − | |||
| − | |||
---- | ---- | ||
Another cause may be the use of backports. A newer 64-bit version of a library is already installed, but the 32-bit version isn't. These packages are given a lower priority so they will not be installed automatically. The solution is to manually install the missing 32-bit package from backports. | Another cause may be the use of backports. A newer 64-bit version of a library is already installed, but the 32-bit version isn't. These packages are given a lower priority so they will not be installed automatically. The solution is to manually install the missing 32-bit package from backports. | ||
---- | ---- | ||
| − | Older versions of Wine (prior to version 6.21) have FAudio as a dependency. These packages are missing on Ubuntu 18.04. These can be downloaded from the [https://download.opensuse.org/repositories/Emulators:/Wine:/Debian/xUbuntu_18.04/ | + | Older versions of Wine (prior to version 6.21) have FAudio as a dependency. These packages are missing on Ubuntu 18.04. These can be downloaded from the [https://download.opensuse.org/repositories/Emulators:/Wine:/Debian/xUbuntu_18.04/ Open Build Service]. |
For Debian 10, these packages are available in backports. | For Debian 10, these packages are available in backports. | ||
| + | ---- | ||
| + | Read also the [https://wiki.winehq.org/FAQ#How_do_I_solve_dependency_errors_when_trying_to_install_Wine.3F FAQ] about dependency errors and tips for troubleshooting dependency issues. | ||
| + | |||
| + | === Winehq key problems === | ||
| + | '''<nowiki>W: GPG error: https://dl.winehq.org/ ... NO_PUBKEY 76F1A20FF987672F</nowiki>''' | ||
| + | |||
| + | Currently, the Wine servers are being synchronized. This means that some users still getting the older .sources file. If you get this warning, edit the winehq-<distro>.sources file and replace ''/usr/share/keyrings/'' to ''/etc/apt/keyrings/''. | ||
| + | |||
| + | For example: | ||
| + | <code>sudo sed -i s@/usr/share/keyrings/@/etc/apt/keyrings@ /etc/apt/sources.list.d/winehq-focal.sources</code> | ||
| + | ---- | ||
| + | '''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 <code>sudo apt update</code> to accept the repository changes. | ||
| + | ---- | ||
| + | '''Apt-key is now deprecated'''. | ||
| − | + | Previously, ''apt-key'' was used to add the Wine key. | |
| − | + | If you get this warning, remove the Wine key with: | |
| − | + | <code>sudo apt-key del "D43F 6401 4536 9C51 D786 DDEA 76F1 A20F F987 672F"</code> And remove the the line about the WineHQ repository from ''/etc/apt/sources.list(.d/*)''. | |
| − | <code>sudo apt-key del "D43F 6401 4536 9C51 D786 DDEA 76F1 A20F F987 672F"</code> | + | That's the reason we are now using a .sources file, instead of adding a new line to ''/etc/apt/sources.list'' |
| − | And remove the the line about the WineHQ repository from ''/etc/apt/sources.list(.d/)''. | ||
=== Ubuntu 22.04 and Wine stable === | === Ubuntu 22.04 and Wine stable === | ||
| Line 84: | Line 91: | ||
Wait a few hours, and try again. If the problem persists for more than a day, file a bug. | Wait a few hours, and try again. If the problem persists for more than a day, file a bug. | ||
| − | |||
| − | |||
== Notes == | == Notes == | ||
| − | + | Menu items are not created for Wine's builtin programs (winecfg, etc.). If you upgrade the Wine distro packages that had added them, they will be removed. You can recreate them yourself using your menu editor. | |
| − | + | ---- | |
| − | + | The Wine files are installed in /opt/wine-<branch>/ | |
| − | + | ---- | |
| − | <code>dpkg-reconfigure wine-<branch>-amd64 wine-<branch> wine-<branch>-i386</code> | + | WineHQ does not offer ''wine-gecko'' or ''wine-mono'' packages. When creating a new [[FAQ#Wineprefixes|wineprefix]], 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. |
| − | and answering yes to the three questions | + | ---- |
| − | + | Beginning with Wine 5.7, the WineHQ 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 | |
| + | <code>dpkg-reconfigure wine-<branch>-amd64 wine-<branch> wine-<branch>-i386</code> and answering yes to the three questions. | ||
| + | ---- | ||
| + | Binfmt_misc registration is not added. Consult your distro's documentation for update-binfmts (<code>man update-binfmts</code>) if you wish to do this manually. | ||
== Installing without Internet == | == Installing without Internet == | ||
| Line 101: | Line 109: | ||
On the machine with internet, add the WineHQ repository and run apt update as described above. | On the machine with internet, add the WineHQ repository and run apt update as described above. | ||
| − | Next, cache just the packages necessary for installing | + | Next, cache just the packages necessary for installing Wine, without extracting them: |
<code> | <code> | ||
| Line 125: | Line 133: | ||
== Building from Source == | == Building from Source == | ||
| − | + | Beginning with 4.0-rc2, the WineHQ repository includes the .dsc, .diff.gz, and .orig.tar.gz files generated by the Open Build Service(OBS). These source packages can be found on <nowiki>"https://dl.winehq.org/wine-builds/<distro>/dists/<version>/main/source"</nowiki> | |
| − | + | ---- | |
| − | These source packages can be found on <nowiki>"https://dl.winehq.org/wine-builds/<distro>/dists/<version>/main/source"</nowiki> | + | The latest versions of Debian and Ubuntu are the multiarch. It is possible to install all 64 and 32 bit dependencies side by side. This allows Wine to be built using the steps listed under [https://wiki.winehq.org/Building_Wine#Shared_WoW64 Shared WoW64]. |
| − | + | ---- | |
| − | + | On older versions of Debian and Ubuntu the multiarch implementation could be incomplete. 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 [https://wiki.winehq.org/Building_Wine Building Wine] for instructions on how to build in a chroot or container. | |
| − | This allows | ||
| − | |||
| − | |||
== See Also == | == See Also == | ||
Revision as of 11:22, 18 September 2022
 |
WineHQ Packages
Although Debian and Ubuntu offer their own Wine packages, these are often several versions behind. To make installing the latest version of Wine as easy as possible, WineHQ has its own repository. Should a newer version of Wine give problems, it is also possible to install an older version of your choice.
Preperation
If your system is 64 bit, enable 32 bit architecture (if you haven't already):
sudo dpkg --add-architecture i386
Download and add the repository key:
sudo mkdir -pm755 /etc/apt/keyrings sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key
Add the repository
Please select your distribution and download the WineHQ sources file:
Click here for 
Ubuntu/ Linux Mint
Click here for 
Debian and compatible derivatives
| Ubuntu 23.10
(Mantic Minotaur) |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/mantic/winehq-mantic.sources |
| Ubuntu 23.04
(Lunar Lobster) |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/lunar/winehq-lunar.sources |
| Ubuntu 22.04
(Jammy Jellyfish) Linux Mint 21.x |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources |
| Ubuntu 20.04
(Focal Fossa) Linux Mint 20.x |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/focal/winehq-focal.sources |
| Debian Testing
(Trixie) |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/trixie/winehq-trixie.sources |
| Debian 12
(Bookworm) |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/bookworm/winehq-bookworm.sources |
| Debian 11
(Bullseye) |
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/bullseye/winehq-bullseye.sources |
Update the package information:
sudo apt update
Install Wine
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 |
The WineHQ Wiki explains the differences between the branches.
Help
Sometimes there are problems installing Wine. If your problem is not listed, search the forum or if you can't find an answer ask your question.
Missing dependencies
WineHQ packages are created and tested for clean Debian and Ubuntu installations. Using PPAs or third-party repositories may prevent the installation of Wine. Often the problem is that these repositories are not multiarch. The required 32 and 64-bit packages are missing or cannot be installed side by side. The deb.sury.org repository is known for causing problems.
Another cause may be the use of backports. A newer 64-bit version of a library is already installed, but the 32-bit version isn't. These packages are given a lower priority so they will not be installed automatically. The solution is to manually install the missing 32-bit package from backports.
Older versions of Wine (prior to version 6.21) have FAudio as a dependency. These packages are missing on Ubuntu 18.04. These can be downloaded from the Open Build Service. For Debian 10, these packages are available in backports.
Read also the FAQ about dependency errors and tips for troubleshooting dependency issues.
Winehq key problems
W: GPG error: https://dl.winehq.org/ ... NO_PUBKEY 76F1A20FF987672F
Currently, the Wine servers are being synchronized. This means that some users still getting the older .sources file. If you get this warning, edit the winehq-<distro>.sources file and replace /usr/share/keyrings/ to /etc/apt/keyrings/.
For example:
sudo sed -i s@/usr/share/keyrings/@/etc/apt/keyrings@ /etc/apt/sources.list.d/winehq-focal.sources
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.
Apt-key is now deprecated.
Previously, apt-key was used to add the Wine key.
If you get this warning, remove the Wine key with:
sudo apt-key del "D43F 6401 4536 9C51 D786 DDEA 76F1 A20F F987 672F" And remove the the line about the WineHQ repository from /etc/apt/sources.list(.d/*).
That's the reason we are now using a .sources file, instead of adding a new line to /etc/apt/sources.list
Ubuntu 22.04 and Wine stable
There are no stable packages for Ubuntu 22.04 yet. Ubuntu Jammy Jellyfish did not exist when Wine 7.0 was released. There will be stable packages whenever 7.0.1 comes out.
Mirror sync in progress?
If you get an error message when trying to install a package from WineHQ that includes the line
Mirror sync in progress?
that is most likely the problem. There are many packages to sync, and it can take a long time to complete.
Wait a few hours, and try again. If the problem persists for more than a day, file a bug.
Notes
Menu items are not created for Wine's builtin programs (winecfg, etc.). If you upgrade the Wine distro packages that had added them, they will be removed. You can recreate them yourself using your menu editor.
The Wine files are installed in /opt/wine-<branch>/
WineHQ does not offer wine-gecko or wine-mono packages. When creating a new wineprefix, 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 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.
Binfmt_misc registration is not added. Consult your distro's documentation for update-binfmts (man update-binfmts) if you wish to do this manually.
Installing without Internet
To install Wine on a Debian/Ubuntu machine without internet access, you must have access to a second Debian/Ubuntu machine (or VM) with an internet connection to download the WineHQ .deb package and its dependencies.
On the machine with internet, add the WineHQ repository and run apt update as described above.
Next, cache just the packages necessary for installing Wine, without extracting them:
sudo apt-get clean
sudo apt-get --download-only install winehq-<branch>
sudo apt-get --download-only dist-upgrade
Copy all of the .deb files in /var/cache/apt/archives to a USB stick:
cp -R /var/cache/apt/archives/ /media/usb-drive/deb-pkgs/
Finally, on the machine without internet, install all of the packages from the flash drive:
cd /media/usb-drive/deb-pkgs
sudo dpkg -i *.deb
Building from Source
Beginning with 4.0-rc2, the WineHQ repository includes the .dsc, .diff.gz, and .orig.tar.gz files generated by the Open Build Service(OBS). These source packages can be found on "https://dl.winehq.org/wine-builds/<distro>/dists/<version>/main/source"
The latest versions of Debian and Ubuntu are the multiarch. It is possible to install all 64 and 32 bit dependencies side by side. This allows Wine to be built using the steps listed under Shared WoW64.
On older versions of Debian and Ubuntu the multiarch implementation could be incomplete. 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
https://build.opensuse.org/project/show/Emulators:Wine:Debian
