Merge the Debian and Ubuntu Wiki

Post issues, bugs, and feature requests about the various WineHQ websites to this forum.
Locked
jkfloris
Level 12
Level 12
Posts: 3136
Joined: Thu Aug 14, 2014 10:10 am

Merge the Debian and Ubuntu Wiki

Post by jkfloris »

The instruction pages of Debian and Ubuntu have a lot in common. My idea is to merge these two pages and put the specific instructions for Debian and Ubuntu on a separate page embedded in the main page.(See https://wiki.winehq.org/Wiki_sandbox#Co ... e_elements for an example)

This will make all the information available in one place and only one, small page needs to be changed when a new version is released.

If there are any comments, additions, I would love to hear them.

What I have in mind:

Code: Select all

<!-- New wiki page -->
= WineHQ Repository =

== 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 ==

Choose your distribution and download the WineHQ sources file:

 - Ubuntu - Debian -
 (Collapsible elements, embed the new wiki pages 'ubuntu-versions' and 'debian-versions')
	
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

== Help ==

=== 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.

See the FAQ entry on dependency errors for tips on troubleshooting dependency issues. (https://wiki.winehq.org/FAQ#How_do_I_solve_dependency_errors_when_trying_to_install_Wine.3F)
----
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 https://download.opensuse.org/repositories/Emulators:/Wine:/Debian/xUbuntu_18.04/
For Debian 10, these packages are available in backports.

=== Winehq key problems ===
* 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
* Previously, apt-key was used to add the wine key. Apt-key is now deprecated. If you get a warning about this, remove the 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.

=== 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.

== 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-<branche>/
* WineHQ does not offer wine-gecko or wine-mono packages. 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 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 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"

* On the new versions of Debian and Ubuntu, the multiarch problems have been fixed. It is possible to install all dependencies side by side.
This allows wine to be built using the steps listed under Shared WoW64.(https://wiki.winehq.org/Building_Wine#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 (https://wiki.winehq.org/Building_Wine) for instructions on how to build in a chroot or container.

== See Also ==

https://build.opensuse.org/project/show/Emulators:Wine:Debian
https://wiki.debian.org/Wine
https://wiki.winehq.org/Packaging

=

<!-- New wiki page -->

= ubuntu-versions = 
<!-- Only a table with the supported versions -->
Ubuntu 22.04 (Jammy Jellyfish)		sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources
Linux Mint 21.x

Ubuntu 20.04 (Focal Fossa)		sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/focal/winehq-focal.sources
Linux Mint 20.x

Ubuntu 18.04 (Bionic Beaver)		sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/bionic/winehq-bionic.sources
Linux Mint 19.x

=

<!-- New wiki page -->
		
= debian-versions =
<!-- Only a table with the supported versions -->
Debian Testing (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

Debian 10 (Buster)			sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/buster/winehq-buster.sources

=

<!-- Redirect https://wiki.winehq.org/Debian and /Ubuntu to WineHQ Repository -->
User avatar
dimesio
Moderator
Moderator
Posts: 13200
Joined: Tue Mar 25, 2008 10:30 pm

Re: Merge the Debian and Ubuntu Wiki

Post by dimesio »

If you're willing to maintain the page, I'm fine with it. My one concern is that the links for the collapsible elements should be glaringly obvious to someone scanning the page quickly. It took me a moment to find the links in your sandbox example. If users don't immediately notice the links, we're going to have a lot of questions on the forum.
jkfloris
Level 12
Level 12
Posts: 3136
Joined: Thu Aug 14, 2014 10:10 am

Re: Merge the Debian and Ubuntu Wiki

Post by jkfloris »

You were right. I couldn't get the drop-down menus to show properly/ obvious.
The new page can be found here: https://wiki.winehq.org/WineHQ_Repository

When a new Ubuntu version is released this page can be updated:
https://wiki.winehq.org/Ubuntu_versions
(Ubuntu 22.10 Kinetic Kudu is already added as a comment)

For Debian:
https://wiki.winehq.org/Debian_versions

I'll wait another day before I redirect the wiki.winehq.org/Ubuntu and /Debian pages to the new page.
Hopefully more Wine servers will be synchronized by then.
User avatar
dimesio
Moderator
Moderator
Posts: 13200
Joined: Tue Mar 25, 2008 10:30 pm

Re: Merge the Debian and Ubuntu Wiki

Post by dimesio »

jkfloris wrote: Sun Sep 18, 2022 5:03 pm You were right. I couldn't get the drop-down menus to show properly/ obvious.
The new page can be found here: https://wiki.winehq.org/WineHQ_Repository
The WineHQ repository also has packages for Fedora, but the new page is only for Debian/Ubuntu. The name of the new page needs to make it clear that the page is only for Debian/Ubuntu so Fedora users don't get confused.
Locked