title
Debian/Ubuntu

 :flag_gb: English  :flag_cn: 简体中文

---

Hoewel Debian/Ubuntu zijn eigen pakketten voor Wine heeft, zijn deze vaak verouderd. Om de installatie van de nieuwste Wine versie zo makkelijk mogelijk te maken heeft WineHQ zijn eigen Debian/Ubuntu repository. Als een nieuwere versie problemen geeft, dan kan er ook oudere versie naar keuze geïnstalleerd worden.

Voorbereiding

WineHQ gebruikt de distributienaam om de repository toe te voegen. Wanneer je deze niet weet, of je gebruikt een distributie die is afgeleid van Debian/ Ubuntu, dan kan deze gevonden worden met:

cat /etc/os-release

Achter UBUNTU_CODENAME of VERSION_CODENAME staat de naam van de distributie. Als beide voorkomen, gebruik dan de naam achter UBUNTU_CODENAME

WineHQ archief toevoegen

Voeg de verificatiesleutel van de WineHQ server toe aan het systeem

sudo mkdir -pm755 /etc/apt/keyrings
wget -O - https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor -o /etc/apt/keyrings/winehq-archive.key -

Voeg de repository toe

De WineHQ pakketten voor Ubuntu 25.10 an Debian Testing zijn WOW64. Hierdoor hoeven de 32-bits pakketten niet meer gebruikt te worden. WoW64 kan 32-bits programma's uitvoeren in een 64-bit wineprefix, maar het kan geen 32-bit prefixes uitvoeren. Als een vorige versie van Wine een 32-bit wineprefix gebruikte, dan moeten de programma's opnieuw geïnstalleerd worden in een 64-bit wineprefix. Op eerdere versies van Debian/ Ubuntu moet de 32-bits architectuur aangezet worden.

Als de naam van je distributie niet voorkomt in de lijst, dan kunnen er oudere pakketten aanwezig zijn op de server van WineHQ.

Voeg alleen repository van de distributie toe.

---

---

Questing

Ubuntu 25.10

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/questing/winehq-questing.sources

---

Plucky

Ubuntu 25.04

Schakel de 32-bits repository in:

sudo dpkg --add-architecture i386

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/plucky/winehq-plucky.sources

---

Noble

Ubuntu 24.04 & Linux Mint 22

Schakel de 32-bits repository in:

sudo dpkg --add-architecture i386

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/noble/winehq-noble.sources

---

Jammy

Ubuntu 22.04 & Linux Mint 21.x

Schakel de 32-bits repository in:

sudo dpkg --add-architecture i386

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources

---

Forky

Debian Testing

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/forky/winehq-forky.sources

---

Trixie

Debian 13

Schakel de 32-bits repository in:

sudo dpkg --add-architecture i386

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/trixie/winehq-trixie.sources

---

Bookworm

Debian 12

Schakel de 32-bits repository in:

sudo dpkg --add-architecture i386

Voeg het sources-bestand toe:

sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/bookworm/winehq-bookworm.sources

---

---

Systeem bijwerken

Werk de pakketbronnen bij met:

sudo apt update

Wine installeren

Installeer één van de volgende pakketten:

Wine versie	Opdracht
Stable versie	sudo apt install --install-recommends winehq-stable
Development versie	sudo apt install --install-recommends winehq-devel
Staging versie	sudo apt install --install-recommends winehq-staging

Op de User's Guide staan de verschillen tussen de verschillende Wine soorten

Help

Het kan gebeuren dat er problemen zijn bij het installeren van Wine. Als het probleem niet hier staat, doorzoek dan het forum. Mocht ook daar geen antwoord te vinden zijn, stel dan daar je vraag.

Ubuntu 25.10 / Debian Testing

Op Debian Testing en vanaf Ubuntu 25.10 zijn de WineHQ pakketten WOW64. Hierdoor hoeven de 32-bits pakketten niet meer gebruikt te worden. Mocht het bijwerken van een oudere Wine versie niet lukken, verwijder dan eerst de oude pakketten:

sudo apt remove winehq-devel wine-devel wine-devel-amd64 wine-devel-i386:i386

Missende afhankelijkheden

Lees de FAQ om afhankelijkheidsproblemen op te lossen. De meeste voorkomende problemen zijn:

Pakketbronnen van derden

De WineHQ pakketten worden gemaakt en getest voor een schone installatie. Het gebruik van PPA's of pakketbronnen van derden kunnen de installatie van Wine verhinderen. Vaak is het probleem dat deze repositories niet multiarch zijn. De benodigde 32 en 64-bit pakketten ontbreken of kunnen niet samen geïnstalleerd worden. De deb.sury.org pakketbron is berucht voor het veroorzaken van problemen. De oplossing is om van de problematische afhankelijkheden de officiële versie te installeren.

KDE Neon

Ubuntu 22.04 KDE Neon gebruikers melden problemen met de libpoppler-glib8 afhankelijkheid. De oplossing is om van dit pakket de Ubuntu versie te installeren. sudo apt install libpoppler-glib8:{i386,amd64}=22.02.0-2ubuntu0.1

Backports

Een andere oorzaak kan het gebruik van backports zijn. Een nieuwe versie van een 64-bit bibliotheek is al geïnstalleerd, maar de 32-bit versie nog niet. De pakketten uit de backports repository krijgen een lage prioriteit mee waardoor ze niet automatisch geïnstalleerd worden. Installeer handmatig het ontbrekende 32-bit pakket uit backports.

Faudio

Oudere versies van Wine (tot versie 6.21) hebben Faudio als afhankelijkheid. Deze pakketten ontbreken voor Ubuntu 18.04. Download de pakketten van de Open Build Service. Voor Debian 10, staan deze pakketten in backports.

Problemen met de Winehq key

• Op 19 december 2018 is de verificatiesleutel van de WineHQ server gewijzigd

  Mocht de sleutel voor die tijd zijn gebruikt, dan moet deze opnieuw worden toegevoegd. Gebruik sudo apt update om de veranderingen door te voeren.

• Apt-key is verouderd

  Vroeger werd apt-key gebruikt om de Wine sleutel toe te voegen. Mocht hierover een melding komen, verwijder de sleutel met:

  sudo apt-key del "D43F 6401 4536 9C51 D786 DDEA 76F1 A20F F987 672F"
  

  Verwijder hierna ook de regel van het WineHQ-archief uit /etc/apt/sources.list(.d/).

Mirror sync in progress?

Als er een foutmelding komt bij het installeren van een WineHQ pakket met de regel Mirror sync in progress? dan is dat waarschijnlijk ook het probleem. Er zijn namelijk heel veel pakketten die gesynchroniseerd moeten worden, wat lang kan duren.

Wacht een paar uur en probeer het nog een keer. Als het probleem meer dan een dag duurt, maak dan een foutrapport aan.

Mijn Debian/Ubuntu versie staat er niet tussen

Wanneer een versie van Debian/Ubuntu niet meer ondersteund wordt, worden er geen nieuwe Wine pakketten meer voor gemaakt. Je kan op de WineHQ server kijken of er oudere pakketten beschikbaar zijn. Het toevoegen van de WineHQ server is niet nodig. Er worden namelijk geen nieuwe versies meer gemaakt. Het downloaden en installeren van de vier WineHQ deb-pakketten is voldoende.

Let op: deze pakketten worden niet meer bijgewerkt en worden niet meer ondersteund.

Notities

• Er worden geen items in het menu gemaakt voor winecfg en andere ingebouwde programma's van Wine. Na het bijwerken van Wine van Debian/Ubuntu, zullen deze weggehaald worden. Deze kunnen met een menu editor zelf gemaakt worden.

• Wine wordt geïnstalleerd in /opt/wine-<soort>/

• Er zijn geen pakketten voor wine-mono en wine-gecko. Deze worden automatisch gedownload en geïnstalleerd als Wine voor de eerste keer wordt gestart of als er een nieuwe wineprefix wordt gemaakt. Als dit niet lukt, lees dan de wiki pagina's van Gecko of Mono.

• Vanaf Wine 5.7 kunnen de WineHQ pakketten ingesteld worden met debconf om gebruik te maken van CAP_NET_RAW. Veel programma's hebben dit niet nodig en is om veiligheidsredenen uitgeschakeld. Als dit wel nodig is (omdat bijvoorbeeld het programma het ping commando nodig heeft) voer dan de volgende opdracht uit en beantwoord de drie vragen met "ja": dpkg-reconfigure wine-<soort>-amd64 wine-<soort> wine-<soort>-i386

• Er wordt geen Binfmt_misc registratie uitgevoerd. Lees de documentatie van Debian/Ubuntu om dit handmatig te doen (man update-binfmts).

• Een volledige Wine installatie op een 64-bit systeem bestaat uit vier pakketten. De Debian Testing / Ubuntu 25.10 pakketten zijn WoW64. Deze distributies hebben alleen de winehq-<soort> en wine-<soort> pakketten.

  • winehq-<soort> Dit pakket zorgt er onder andere voor dat het wine commando systeembreed beschikbaar is.

  • wine-<soort> Dit pakket heeft de volgende twee pakketten als afhankelijkheid en zorgt voor een werkende installatie.

  • wine-<soort>-amd64 Het 64-bit gedeelte van Wine.

  • wine-<soort>-i386 Het 32-bit gedeelte van Wine.

  Door Wine over verschillende pakketten te verdelen, is het mogelijk om verschillende soorten naast elkaar te installeren.

  Bijvoorbeeld: Gebruik Wine-stable als standaard versie en installeer Wine-staging om sommige programma's te testen.

  Installeer Wine-stable met:

  sudo apt install --install-recommends winehq-stable

  Installeer Wine-staging met:

  sudo apt install --install-recommends wine-staging (Let op: er staat geen hq na wine)

  Voer een programma uit met Wine-stable:

  wine program.exe

  Voer een ander programma uit met Wine-staging:

  WINEPREFIX=~/wine-staging /opt/wine-staging/bin/wine program.exe

  (Het wordt aanbevolen om elke Wine-soort zijn eigen wineprefix te geven.)

• Er staan meerdere versies van Wine op de repository. Standaard wordt de laatste versie geïnstalleerd. Gewoonlijk wordt de nieuwste versie aanbevolen, maar het kan voorkomen dat een oudere versie gewenst is. Gebruik apt policy winehq-<soort> om de beschikbare versies te tonen.

  Een oudere versie kan geïnstalleerd worden met:

  sudo apt install winehq-<branch>=<version>
  

  Bijvoorbeeld:

  sudo apt install winehq-staging=7.12~bookworm-1
  

  Als de Wine pakketten moeten worden afgewaardeerd, dan moeten alle vier de pakketten gegeven worden:

  sudo apt install winehq-staging=7.12~bookworm-1 wine-staging=7.12~bookworm-1 wine-staging-amd64=7.12~bookworm-1 wine-staging-i386=7.12~bookworm-1
  

Een installatie zonder internet

Om Wine op een computer zonder internetverbinding te kunnen installeren is een tweede computer (of VM) met een internetverbinding nodig. Deze kan de benodigde deb-pakketten downloaden.

Voeg op de computer met de internetverbinding de WineHQ repository toe. Haal daarna de pakketten binnen zonder deze te installeren:

sudo apt-get clean
sudo apt-get --download-only install winehq-<branch>
sudo apt-get --download-only dist-upgrade

Kopieër alle deb-bestanden van /var/cache/apt/archives naar een USB stick:

cp -R /var/cache/apt/archives/ /media/usb-drive/deb-pkgs/

Nu kunnen de deb-pakketen geïnstalleerd worden op de computer zonder internetverbinding

cd /media/usb-drive/deb-pkgs sudo dpkg -i *.deb

Wine zelf compileren

• Vanaf versie 4.0-rc2, heeft de WineHQ repository ook de .dsc, .diff.gz, en .orig.tar.gz bestanden. Deze bronbestanden kunnen hier gevonden worden https://dl.winehq.org/wine-builds/<debian|ubuntu>/dists/<versie>/main/source
• De nieuwste versies van Debian/Ubuntu is multiarch. Het is mogelijk om alle benodigde 64 en 32-bit pakketten naast elkaar te installeren. Hierdoor kan Wine gebouwd worden door de instructies te volgen die staan op de WineHQ wiki.
• Oudere versies van Debian/Ubuntu zijn waarschijnlijk niet multiarch. Het lukt niet om de 32 en 64-bit bibliotheken naast elkaar te installeren. Op een 64-bit systeem moet dan een aparte omgeving gemaakt worden om het 32-bit gedeelte te maken. Op de WineHQ wiki staan instructies hoe dit kan in een chroot of een container.

Lees ook

• De officiële WineHQ download website for Debian/Ubuntu.
• De scripts en logbestanden van de WineHQ Debian/Ubuntu pakketten
• De Debian Wiki's pagina van Wine.
• Packaging