Running x86 Software on a Raspberry Pi using Box86?

The Raspberry Pi is an extremely versatile single board computer that is capable of many tasks. However, since it utilizes an ARM processor, it cannot natively run x86 software designed for PCs. With the help of an emulation program called Box86, you can now run x86 software on a Raspberry Pi with reasonable performance.

Running x86 Software on a Raspberry Pi using Box86?

Benefits of Running x86 Software on a Raspberry Pi

There are several advantages to using Box86 to emulate x86 software on a Raspberry Pi:

  • Access to a wider range of software typically not available on ARM devices
  • Ability to reuse older x86 software and games
  • More software compatibility overall
  • Fun technical challenge and learning experience

How Box86 Works to Emulate x86 Software

Box86 utilizes several techniques to translate and run x86 software on devices with ARM processors:

  • Dynamic binary translation of machine code instructions from x86 to ARM as the software runs
  • Implementation of equivalent x86 Linux syscalls in the emulator
  • Custom versions of libraries like glibc tailored for Box86
  • Caching translated blocks of code to reduce overhead

By employing these techniques, Box86 can achieve reasonable performance for many x86 programs, with certain software running at nearly native speeds.

Installing Box86 on a Raspberry Pi

Getting Box86 up and running on a Raspberry Pi does require a few steps. Here is an overview of what is needed:

Supported Hardware

  • Raspberry Pi 2 or newer (Pi 3 recommended)
  • A minimum of 2GB RAM (4GB preferred)
  • Running 64-bit OS (32-bit not supported)

Software Dependencies

  • A 64-bit Raspberry Pi OS (previously called Raspbian)
  • Python 3.7+ and pip3
  • Dependencies: sudo apt install git build-essential libc6-dev

Downloading Box86

Clone the Box86 repository:

git clone


cd box86


This will compile Box86 and create a .so shared library file.


To intercept syscalls and run x86 binaries, the Box86 shared library must be preloaded by setting the LD_PRELOAD environment variable before execution:

export LD_PRELOAD=/path/to/box86/

With that, Box86 is ready to run x86 ELF binaries!

Useful Optimizations for Better Performance

There are several options and environment variables that can help optimize performance when running x86 software through Box86:

Using Box86’s CPU JIT Compiler

  • Enabling the integrated DynamoRIO CPU JIT compiler can greatly accelerate software speed
  • To enable, export BOX86_DYNAREC=dynarec before execution
  • Provides similar benefits as native JIT compiling

Reducing Memory Overhead

  • By default, Box86 uses memory very aggressively for caching and dynamic recompilation
  • For better performance on systems with 2GB RAM, restrict Box86 memory usage:
    • export BOX86_NOBANKS=1
    • export BOX86_STRICT_MISMATCH=1
  • This forces Box86 to more aggressively reuse memory

Using Multiple CPU Cores

  • Emulation can leverage multiple cores by splitting translation work
  • export BOX86_THREADS=2 (replace 2 with desired number of threads)

Avoiding Unnecessary Log Output

  • Verbose logging has a performance cost
  • export BOX86_LOG=0 to disable most logging statements

Compatible x86 Software and Games

A wide variety of older x86 games and programs can potentially run using Box86. Some examples include:


  • Classic DOS games – Duke Nukem, Doom, Quake
  • Early 2D Windows games – Age of Empires 2, StarCraft, Diablo
  • Many DirectX 8/9 games from the 2000s – Half-Life 2, Unreal Tournament 2004

Productivity Software

  • Older Windows Office suites
  • Photoshop CS2
  • Early PC emulators – DOSBox, ScummVM

Specialized Programs

  • Old x86 Linux tools
  • Vintage synthesizer plugins, trackers, and DAW software
  • 16-bit Windows 3.1 applications

Your mileage may vary depending on the complexity of the x86 software and level of hardware acceleration used. Testing a wide range of programs is part of the fun!

Troubleshooting Issues with Box86

As with any emulator, Box86 will not work perfectly with all x86 software. But there are a few common techniques to help troubleshoot issues:

  • Check for missing x86 libraries – Box86 cannot emulate everything
  • Try older versions of software if available
  • Disable hardware rendering features if graphics are glitchy
  • Verify all dependencies are installed for the program
  • Check dmesg and logs for crash info
  • Enable tracing features in Box86 for deeper insight
  • Try both ARM32 and ARM64 versions of Box86

Getting complex x86 software running smoothly may require patience and experimentation with different Box86 settings. But the reward is opening up a huge array of classic PC software to your Raspberry Pi that was never possible before!

Key Takeaway

The key points to highlight are:

  • Box86 enables running x86 Windows and DOS software on Raspberry Pi by translating x86 machine code to ARM
  • Emulating x86 software can provide fun retro gaming and allow reuse of older programs
  • Optimizing memory usage and enabling JIT compilation helps improve performance
  • Compatible software includes classic games, Windows office suites, and niche tools – experimentation provides best results

While not all x86 applications will function flawlessly, Box86 opens up many possibilities previously unavailable on ARM devices like the Raspberry Pi. Tinkering with the emulator and discovering compatible software can be highly rewarding.


In closing, installing Box86 on a Raspberry Pi grants the ability to reuse, experiment and play with decades of x86 software that predates the dominance of ARM processors. Box86 utilizes dynamic binary translation to run Windows, DOS, and Linux executables compiled for x86 on a Raspberry Pi’s ARM chipset. Despite some inherent emulation overhead, techniques like enabling the integrated DynamoRIO JIT compiler allow reasonable performance for lighter games and applications. The journey of getting both classic blockbuster 1990’s PC games and obscure niche software running on a $35 Raspberry Pi device makes experimenting with Box86 an exciting endeavor for any tech or retrogaming enthusiast despite some tinkering and file management involved.

Frequently Asked Questions

Q: Does Box86 work on Raspberry Pi OS 32-bit?
A: No, Box86 only works on 64-bit operating systems due to the memory requirements of dynamic recompilation. Use the 64-bit version of Raspberry Pi OS.

Q: Can Windows programs with antivirus detect Box86 as a threat?
A: Yes, some antivirus or malware suites may detect aspects of Box86 as suspicious since it utilizes techniques like dynamic code generation. Adding exclusions for Box86 can prevent false positives.

Q: Will my x86 program lose performance compared to running natively?
A: Emulation overhead is unavoidable, though JIT compiling helps minimize slowdowns. But for many older or lightweight programs, especially games 2D games, Box86 performance can match or even exceed native x86 in some cases.

Q: Can x86 viruses or malware run on ARM using Box86?
A: No, Box86 only emulates user-mode x86 code, not full system calls, interrupts, or kernel access. So malware cannot spread from emulated x86 programs to the host ARM environment.

Q: Why doesn’t video playback performance match native speeds?
A: Hardware video decoding features are tied to x86 GPUs and drivers. So without native GPU access, video playback is forced to run in software at higher CPU cost. Games using 3D rendering are also more impacted.

Q: Will productivity software like Office 97 work seamlessly?
A: Basic Office 97 functionality runs at usable speeds, though performance is not 100% native. More visual intense transitions and effects can demonstrate slowdowns. Saving files to Windows filesystems requires extra configuration.

Q: Can I compile custom x86 programs like AutoCAD or Notepad++ to run with Box86?
A: Compiling 32-bit x86 Linux builds of custom programs can work with Box86. However, complex commercial Windows software requires extensive dependencies and kernel access exceeding emulation capabilities.

Q: Does Box86 emulate DirectX API calls?
A: Limited support for translating DirectX commands is present, enabling older DirectX 7/8/9 games and software. However, without GPU hardware access, performance depends greatly on the complexity of visual effects. Simple 2D sprite games can run full speed.

Q: Can I use Box86 together with GPU acceleration via mesa drivers?
A: There is experimental work on integrating Vulkan translation support into Box86 to enable accelerated 3D rendering on Linux. But currently 3D performance relies completely on CPU emulation, limiting compatibility for games requiring graphics hardware access.

Q: Do all settings combinations work smoothly together?
A: With complex dynamic recompilation, issues can arise from conflicting settings. Test each optimization individually before combining multiple environment variables. Disable Dynarec or multi-threading if stability issues occur.

Q: Does Box86 require specific compiler flags or libraries to work properly?
A: The standard script handles configuration requirements for most use cases. Only if compiling niche x86 software manually would tailored CXXFLAGS or LDFLAGS environment variables be needed, handled on a per-program basis.

Q: What Ubuntu or Debian packages are compatible with Raspbian?
A: While not directly interchangeable, Ubuntu ARM64 packages for libraries like SDL2, OpenGL, gtk etc can often run correctly on 64-bit Raspbian via Box86 for added compatibility. Mileage varies by complexity.

Q: Can I run x86 containers like Docker using emulation?
A: Early experimental work on x86 Docker emulation shows promise. But practical usage currently lags far behind QEMU virtualization efficiency. There are tradeoffs between full system emulation flexibility vs performance overhead.

Q: Does AMD or Intel-specific x86 machine code cause issues?
A: Box86 converts all x86 code to generic ARM assembly language, enabling cross-compatibility. So there are no conflicts running AMD64 Windows programs on an emulated Intel chipset. Compatibility ultimately depends on syscalls and dependencies rather than chipset.


Leave a Comment