Easy Raspberry basics: Project 11a Install and Run Wine on Raspberry PI 3 model B board

of Acoptex.com in Raspberry Pi 3

Raspberry basics: Project 11a

Project name: Install and Run Wine on Raspberry PI 3 model B board

Tags: Raspberry, Raspberry PI 3 model B board, ExaGear Desktop, Wine

In this project, you need these parts :

1.Raspberry PI 3 model B 1 pc

2. Micro SD card and SD card adapter 1 pc

3. Micro USB power supply (2.1 A, max 2.5 A) 1 pc

4. USB keyboard 1 pc

5. USB mouse 1 pc

6. TV or PC monitor 1 pc


We will learn how to install and run Wine on Raspberry PI 3 model B board.

Wine (originally an acronym for "Wine Is Not an Emulator") is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, macOS, & BSD. Instead of simulating internal Windows logic like a virtual machine or emulator, Wine translates Windows API calls into POSIX calls on-the-fly, eliminating the performance and memory penalties of other methods and allowing you to cleanly integrate Windows applications into your desktop.

Wine is a compatibility layer that allows running Windows applications on Linux systems (www.winehq.org).

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. 

Understanding the Raspberry PI 3 model B

The Raspberry Pi 3 is the third-generation Raspberry Pi. It replaced the Raspberry Pi 2 Model B in February 2016.


  • Quad Core 1.2GHz Broadcom BCM2837 64bit CPU
  • 1GB RAM
  • BCM43438 wireless LAN and Bluetooth Low Energy (BLE) on board
  • 40-pin extended GPIO
  • 4 USB 2 ports
  • 4 Pole stereo output and composite video port
  • Full size HDMI
  • CSI camera port for connecting a Raspberry Pi camera
  • DSI display port for connecting a Raspberry Pi touchscreen display
  • Micro SD port for loading your operating system and storing data
  • Upgraded switched Micro USB power source up to 2.5A

Signals and connections of the Raspberry PI 3 model B

Step by Step instruction

We recommend using a high-performance SD card for increased stability as well as plugging your device into an external display to see the default application booting up.

1. Installing ExaGear Desktop

We assume that you have Windows 10 installed on your PC and Raspbian OS installed on your Raspberry PI 3 board.

  1. Insert your micro SD card with Raspbian OS to Raspberry Pi 3 board.
  2. Connect the TV or PC monitor Display port (HDMI Port) to your Raspberry PI 3 board HDMI Port (HDMI cable required).
  3. Make sure that your monitor or TV is turned on, and that you have selected the right input (e.g. HDMI 1,  etc).
  4. Plug in your USB mouse and USB keyboard to Raspberry PI 3 board USB ports.
  5. Get connected. Connect an Ethernet cable to 10/100 LAN port of Raspberry Pi 3 or plug in WiFi adapter (see the list of supported here) to USB port of Raspberry Pi 3.
  6. Connect Micro USB power supply to Raspberry PI 3 board micro USB input.
  7. The Raspberry PI desktop will start up.
  8. Open Terminal window and type the command: sudo apt-get update
  9. Then type the command: sudo apt-get install exagear-desktop to install ExaGear Desktop. Press Y button on the keyboard when you see the message Do you want to continue?Y/n

2. Launch guest x86 system

  1. Enter the guest x86 system using the following command: exagear. A graphical windows will pop up and offer you to activate the trial of ExaGear Desktop. 

  2. Enter your first name and last name, email address and press Activate Trial button.
  3. You will see the message - You successfully go trial. Press Close button. You will be forwarded into the guest x86 system in the terminal. You can check that you are in x86 environment by running the command: arch
  4. It is recommended to update apt-get repositories on the first launch of the guest system: sudo apt-get update

  5. Type the command to restart your Raspberry Pi 3: sudo reboot

3. Installing Wine

  1. The Raspberry PI desktop will start up. Open Terminal window and enter the guest x86 system using the following command: exagear
  2. It is recommended to update apt-get repositories on the first launch of the guest system: sudo apt-get update

  3. Type this command to install Wine inside the guest system: sudo apt-get install wine
  4. Package manager will offer you to install a bunch of packages. Agree and start the installation.
  5. After installation type the command: wine --version to check the version installed.

4. Running the 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.


  1. Download MS Word Viewer installer by typing this command: wget https://download.microsoft.com/download/6/a/6/6a689355-b155-4fa7-ad8a-dfe150fe7ac6/wordview_en-us.exe
  2. To be able to view .docx format download MS Office Compatibility Pack: wget https://download.microsoft.com/download/9/2/2/9222D67F-7630-4F49-BD26-476B51517FC1/FileFormatConverters.exe
  3. To install MS Word Viewer using Wine type the command: wine wordview_en-us.exe
  4. After a while, you will see the Default – Wine desktop window and MS office Word Viewer installer with a dialog window inside. 
  5. Follow the prompts to start the installation.
  6. Install MS Office Compatibility Pack using Wine the same way by typing the command: wine FileFormatConverters.exe
  7. Configure Wine window size.
  8. 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 by typing the command: winecfg
  9. Then open the Graphics tab in Wine configuration window and uncheck Emulate a virtual desktop checkbox. Press Apply and then Ok buttons.
  10. Congrats!!!Now you can close guest x86 terminal and run MS Word Viewer from the Raspbian start menu.
  11. Go to Raspberry icon-> Wine->Programs->you will see your program listed here.
  12. Wine Application Database contains information on application compatibility with Wine as well as tips and tricks on Wine configuration for a particular application.



We have learnt how to install, run Wine on Raspberry PI 3 model B board.


  • No libraries needed in this project


  • No sketches needed in this project

Other projects of Acoptex.com
Medium Basics: Project 083w Sipeed Maixduino board - Using PlatformIO IDE of Acoptex.com in Sipeed Maixduino 08-08-2019
Medium Basics: Project 083e Sipeed Maixduino board - Uploading MaixPy of Acoptex.com in Sipeed Maixduino 04-08-2019
Medium Basics: Project 083f Sipeed Maixduino board - Using MycroPython of Acoptex.com in Sipeed Maixduino 04-08-2019

Published at 25-09-2018
Viewed: 7517 times