Run Wine on Raspberry Pi

Step-by-step instruction to run Wine on Raspberry Pi

using ExaGear Desktop


Wine is a compatibility layer that allows running Windows applications on Linux systems ( But when it comes to Raspberry Pi, things are getting a bit more complicated. And here is why.

Windows apps are mostly compiled for x86 CPU architecture and they won’t run on ARM-based Raspberry Pi with Wine. ExaGear Desktop can solve the problem. It provides x86 Linux environment on your ARM device making it possible to run x86 Windows apps with Wine.

Another complexity comes from Raspberry Pi specificity with user/kernel virtual memory split. You should build Wine for 2G/2G split systems (by default it is configured for 3G/1G). We did it and added the right version of Wine to default repositories of ExaGear’s guest x86 system. So now to run Wine on Raspberry Pi using ExaGear Desktop you just need to follow setup instruction given below.

Raspberry Pi test stand configuration


Raspberry Pi 2 Model B

Raspberry Pi 3


1000 MHz

1200 MHz




Operating System

Raspbian Jessie from May 2016

Raspbian Jessie from May 2016


Wine 1.8

Eltechs ExaGear Desktop for Raspberry Pi 2

Wine 1.8

Eltechs ExaGear Desktop for Raspberry Pi 3

Wine setup instruction

Install ExaGear Desktop

1. Put ExaGear Desktop archive with installation packages and ExaGear Desktop license key in the same folder. Open Terminal (command line), move to this folder and unpack the archive using the following command:

$ tar -xvzpf exagear-desktop-rpi3.tar.gz

2. Install and activate ExaGear by running the script:

$ sudo ./

That’s it.

Launch guest x86 system

3. Enter the guest x86 system by entering the following command:

$ exagear
Starting the shell in the guest image /opt/exagear/images/debian-8

You’re in the x86 environment that can be checked by running the ‘arch’ command:

$ arch

4. It is recommended to update apt-get repositories on the first launch of the guest system:

$ sudo apt-get update

Install Wine

5. Install Wine in Terminal inside the guest system:

$ sudo apt-get install wine

Package manager will offer you to install a bunch of packages. Agree and start the installation.

6. Once the installation process is finished make sure that you have the Eltechs build of Wine installed:

$ wine --version

Run Wine

Now you can run .exe files with Wine and get x86 Windows programs installed and running on your Raspberry Pi.

Let’s take Microsoft Word Viewer as an example.

7. Download MS Word Viewer installer:

$ wget

To be able to view .docx format download MS Office Compatibility Pack:

$ wget

8. Install MS Word Viewer using Wine:

$ wine wordview_en-us.exe

After a while, you will see the “Default – Wine desktop” window and MS office Word Viewer installer with a dialog window inside. Follow the prompts to start the installation.

Install MS Word Viewer using Wine on Raspberry Pi

9. Install MS Office Compatibility Pack using Wine the same way:

$ wine FileFormatConverters.exe

10. Configure Wine window size.

By default, the Wine window has a fixed size that is not convenient to view Word documents. You can configure Wine to be able to run MS Word Viewer in a separate window with adjustable size. To do this run winecfg tool from Terminal:

$ winecfg

Then in “Wine configuration” window open the “Graphics” tab and unset “Emulate a virtual desktop” checkbox. Click on “Apply” and then “Ok” buttons.

Configure Wine on Raspberry Pi

This is it. Now you can close guest x86 terminal and run MS Word Viewer from the Raspbian start menu.

11. Run MS Word Viewer:

Run MS Word Viewer with Wine on Raspberry Pi

Final notes

This way you can install and run other Windows applications compatible with Wine on Raspberry Pi with ExaGear Desktop. Here is the Wine Application Database where you can get information on application compatibility with Wine as well as tips and tricks on Wine configuration for a particular application.

Using Wine with the ExaGear emulator you can try things you’ve thought were impossible before. For example, we’ve even tried to launch Netflix on RPi model 3 (learn our Raspberry Pi 3 Netflix case) or created a fully automatic trading robot by launching MetaTrader 4 on Raspberry Pi.We’re continuing to make different interesting projects for you, so stay in touch to learn more.

It is also worth noting that with ExaGear Desktop you can run practically any x86 app on Raspberry Pi and other ARM-based devices such as  Odroid, Banana Pi, Beagleboard, Cubox, Jetson, Cubieboard etc.

Get my ExaGear Desktop

Also on Eltechs

Virtual machine for Rasberry Pi - ExaGear Desktop

Virtual machines for Raspberry Pi

Choose the best virtual machine for your Raspberry Pi or any other ARM device comparing ExaGear and its alternatives

TeamSpeak 3 Server on Raspberry Pi

Build a TeamSpeak 3 Server on Raspberry Pi

In this post, we will tell you how to setup TeamSpeak 3 Server on Raspberry Pi with ExaGear Desktop which allows running any x86 apps on ARM mini PCs.

Microsoft Dotnet Framework on Raspberry Pi

Run MS .NET Framework 4.5 on Raspberry Pi

Set and run .NET Framework on Raspberry Pi for any specific reason. Step-by-step detailed guide.

Wine Raspberry Pi Netflix Setup guide

Netflix on Raspberry Pi

Install Netflix on Raspberry Pi and enjoy your favourite videos online right on your Raspbian or other ARM-based mini PC

Get you gaming experience beyond RetroPie level

Gaming Beyond RetroPie

Run iconic PC games like Arcanum, Disciples II and Fallout on RPi with Exagear and improve your device gaming level beyond Retropie.

How to turn Raspberry Pi into gaming emulator device

Raspberry Pi Gaming emulator

A detailed guide on how to make your Raspberry Pi a powerful gaming emulator and run any iconic and nostalgic PC games on Raspbian (or any other ARM).

ExaGear is registered trademark of Eltechs, Inc. Raspberry Pi is a trademark of the Raspberry Pi Foundation. Other trademarks and product names are the property of their respective owners.