November 18, 2026
The procedure on this page installs the latest version of Wine Stable, Wine Development, or Wine Staging.
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.
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
$ 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 -
$ sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/debian/dists/bookworm/winehq-bookworm.sources
$ sudo apt update
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
$ wine --version
To bring up Wine's configuration panel, open a Terminal window and execute winecfg. Accept the offer to install Wine Mono.
$ wine winecfg
$ wine clock
Take a look, and then close the Clock panel.
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 Mono![]()
"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 Gecko![]()
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 Gecko![]()
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
