Red Wine in a GlassHow to Install Wine on Debian BookwormCSS HTML Validator Logo
HOME Tutorials & Essays About
Tutorials & Essays About

November 18, 2026

How to Install Wine on Debian 12 Bookworm

Including the Debian 12 Desktops

GNOME, KDE, LXDE, Xfce, Cinnamon, and MATE

And many other Debian 12 based distributions

Devuan 5, Linux Mint Debian 6, MX Linux 23, Peppermint OS Debian Base (Bookworm), Peppermint OS Devuan Base (Daedalus), SparkyLinux 7

An image reading copy paste into terminal

The procedure on this page installs the latest version of Wine Stable, Wine Development, or Wine Staging.

Sudo

In case you find that you cannot use sudo, an Appendix at the end of this document explains how to install sudo and enable it for yourself.

Check installed architectures

Verify 64-bit architecture. The following command should respond with "amd64".

$ dpkg --print-architecture

See if 32-bit architecture is already installed. The following command should respond with "i386"

$ dpkg --print-foreign-architectures

If it does not display "i386", execute the following.

$ sudo dpkg --add-architecture i386

Re-check with

$ dpkg --print-foreign-architectures

Download and add the WineHQ repository key

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

Add the WineHQ repository

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

Update the package database

$ sudo apt update

Install Wine

The next command installs Wine Stable. To install Wine Development or Wine Staging, replace winehq-stable  by  winehq-devel or winehq-staging

Sometimes Wine Stable is unavailable, but Wine Development and Wine Staging can still be installed.

$ sudo apt install --install-recommends winehq-stable

Verify the installation

$ wine --version

Configure Wine

To bring up Wine's configuration panel, open a Terminal window and execute winecfg. Accept the offer to install Wine Mono.

$ wine winecfg

A simple test

Display a clock

$ wine clock

Take a look, and then close the Clock panel.

Appendix: Wine Mono and Wine Gecko

Wine Mono and Wine Gecko are Windows apps required for full functionality of a Wine installation.

"Mono is an open-source and cross-platform implementation of the .NET Framework. Wine Mono is a fork of Mono that Wine uses to run .NET Framework applications." WineHQ re Wine MonoNew Window Icon

"Wine implements its own version of Internet Explorer. The implementation is based on a custom version of Mozilla's Gecko Layout Engine. … [If] your application tries to display a site, Wine loads and uses its custom implementation of Gecko." WineHQ re Wine GeckoNew Window Icon

Because Wine Mono and Wine Gecko are Windows apps, they can be installed only after Wine is installed and configured.

If Wine Mono or Wine Gecko is not part of your Wine installation, you can manually install either or both. This is described in How to Manually Install Wine Mono and Wine GeckoNew Window Icon

Appendix: Enable sudo

This appendix explains how to install sudo and grant yourself sudo privileges. To do these, you must know the root password.

Login as superuser.

$ su -l

The next two commands will install sudo, if it is not already installed.

# apt update
# apt install sudo

With sudo installed, the following enables you to use sudo. Just replace user-name by your own user name.

# adduser user-name sudo

Log out of the root account and close the Terminal window.

# exit
$ exit

Close any open apps.

In order to activate sudo for your user name, Restart your Computer.

When logged in again, continue from here to verify sudo is installed and properly configured.

-------- Waiting for computer to restart --------

To verify you can now use sudo, open a Terminal session and issue the following command.

$ sudo echo Hello

The test is successful if, after requesting and receiving your password, Hello is displayed.


Did you find this page helpful? Have constructive feedback? Wisdom to share?

Send email to Email Address

Privacy PolicyNew Window Icon

Image showing Athena serving Wine to Heracles