+1
Daily
5,715
stars
490
forks
78
watchers
3,005
prs
1,575
issues
22
releases
README
!Official logo Box64: Linux Userspace x86-64 Emulator with a Twist Website | Changelog | 中文 | Українська | Report an Error !Build Status !Stars !Forks !Contributors !Pull Requests !Issues --- Check out our game compatibility list at https://box86.org/app/, please help us improve it! --- Box64 enables running x86_64 Linux programs, including games, on non-x86_64 Linux systems such as Arm (64-bit little-endian host system required). Box64 leverages native system libraries (libc, libm, SDL, OpenGL), offering ease of integration and surprising performance in many applications. For performance benchmarks, check this analysis. With DynaRec for Arm, RISC-V and LoongArch platforms, Box64 achieves a speed boost 5-10x faster than the interpreter alone. For a deeper look at DynaRec, see Inner workings. For a more detailed look at Box64 internals and optimization strategies, see our EuroSys 2026 paper, Practical and Efficient x86-64 Emulation on RISC-V, which focuses on RISC-V but covers many techniques that apply more broadly to Box64. _Logo and icon by @grayduck - Thank you!_ --- Usage - $ box64 ./program [args] to run Linux x86_64 programs. - $ box64 -k to kill all the emulated processes. - $ box64-bash to have an x86_64 bash environment. - Want to use wine? see Wine Documentation. Box64 also offers environment variables and rcfile to control its behavior. For details, see Usage Documentation. --- Compiling and Installation - Compilation Instructions - Bundle x86 Libraries - Wine Installation for Box64 --- Version History See the Changelog for version updates. --- Platform Compatibility Notes Box64 requires 64-bit libraries on the host system, as it directly translates x86_64 function calls. For 32-bit binaries, use Box86 or Box32. Notes 1. Box32 is still experimental, but it's pretty stable now and can be used. 2. Some shell scripts (such as the GOG game installer) may rely on uname -m to determine the current architecture. Please run them as box64 script.sh to allow Box64 to take over. Note that DynaCache is now enabled by default (with compression). This will creates files in ~/.cache/box64 to save generated code for executed binaries and libraries, so launch time can be greatly reduced on second run. The files are compressed and will take up to 2Gb by default. You can disable DynaCache writing, by switching it to a Read-only mode by creating (or modifying) ~/.box64rc and writing there ini [] BOX64_DYNACACHE=2 (or 0 to completely disabled it). Please refer to Usage Documentation for more details on how to configure Box64. --- Configuration Box64 has configuration files located in /etc/box64.box64rc and ~/.box64rc, both formatted as .ini files. If you don’t want to use the default /etc/box64.box64rc file, copy it to ~/.box64rc to ensure compatibility. Settings priority: ~/.box64rc /etc/box64.box64rc Command line. For more information
Top issues
#1182Valheim Dedicated Server Crashes Post Unity 2022 Update124 comments · 2024-01-02#1780[BOX32] Getting the native Linux version of steam working on Apple silicon70 comments · 2024-08-31#3593Bunch of game performance tested on rk358846 comments · 2026-02-28#1046Satisfactory Dedicated Server34 comments · 2023-10-29#2020(Documentation request) Add a FAQ on the website32 comments · 2024-11-12#287box64 Viber: Symbol xcb_randr_get_output_info_name_length not found27 comments · 2022-04-21#1376Unable to launch war thunder26 comments · 2024-03-20#3632Packet tracer: SIGABRT crash (Console logs + KDE crash process overview + coredump)19 comments · 2026-03-09
Discussions
#4719is "Available in WowBox64." in docs/USAGE.md ONLY wowbox64 or in box64 AND wowbox64?0 comments · 2026-11-15#4298Potential task for Wine + Box86/64 developer1 comments · 2026-08-27#4128Why does Box64 tracing stop after my_execv() on x86_64?1 comments · 2026-07-27#3976Box32: x86 LD_PRELOAD dropped as ELFCLASS32 inside a system() call - expected?3 comments · 2026-06-22#3962Can Termux with proot and box64 run Linux Unity games?3 comments · 2026-06-18#3947box64 behavior after execv(wine) on x86_64 vs ARM641 comments · 2026-06-14#3918LD_PRELOAD1 comments · 2026-05-29#3881Box64 Trace Stops After my_execv Execution1 comments · 2026-05-22
Latest release
v0.4.4 v0.4.4 2026-08-02What's Changed A new box64-configurator is now present (a python app) to help managing custom RCFILE profiles. It is available in both english and chinese. DynaCache is now enabled by default. It will compress the files and use up to 2GB of disk space. You can use box64-configurator on the special [] profile to change default values More improvements on emulation accuracy that help running more DRM'd games Many Speed improvements in the LoongArch backend Many new opcodes in the RISC-V backend More details in New release blog Contributions [DYNAREC] Optimized native_pclmul