2022-03-08 10:04:09 +00:00
|
|
|
[中文](https://github.com/FEX-Emu/FEX/blob/main/docs/Readme_CN.md)
|
2019-07-13 09:41:34 +00:00
|
|
|
# FEX - Fast x86 emulation frontend
|
2021-03-21 08:53:51 +00:00
|
|
|
FEX allows you to run x86 and x86-64 binaries on an AArch64 host, similar to qemu-user and box86.
|
|
|
|
|
It has native support for a rootfs overlay, so you don't need to chroot, as well as some thunklibs so it can forward things like GL to the host.
|
2024-05-03 03:38:13 +00:00
|
|
|
FEX presents a Linux 5.0+ interface to the guest, and supports only AArch64 as a host.
|
2021-03-21 08:53:51 +00:00
|
|
|
FEX is very much work in progress, so expect things to change.
|
|
|
|
|
|
2022-01-04 00:05:05 +00:00
|
|
|
|
|
|
|
|
## Quick start guide
|
2024-10-22 21:13:56 +00:00
|
|
|
### For Ubuntu 22.04, 24.04 and 24.10
|
2022-01-04 00:05:05 +00:00
|
|
|
Execute the following command in the terminal to install FEX through a PPA.
|
|
|
|
|
|
2022-02-09 22:01:48 +00:00
|
|
|
`curl --silent https://raw.githubusercontent.com/FEX-Emu/FEX/main/Scripts/InstallFEX.py --output /tmp/InstallFEX.py && python3 /tmp/InstallFEX.py && rm /tmp/InstallFEX.py`
|
2022-01-04 00:05:05 +00:00
|
|
|
|
|
|
|
|
This command will walk you through installing FEX through a PPA, and downloading a RootFS for use with FEX.
|
|
|
|
|
|
|
|
|
|
Ubuntu PPA is updated with our monthly releases.
|
|
|
|
|
|
|
|
|
|
### For everyone else
|
2022-03-29 09:27:43 +00:00
|
|
|
Please see [Building FEX](#building-fex).
|
2022-01-04 00:05:05 +00:00
|
|
|
|
2021-03-21 08:53:51 +00:00
|
|
|
## Getting Started
|
2024-05-03 03:38:13 +00:00
|
|
|
FEX has been tested to build and run on ARMv8.0+ hardware.
|
|
|
|
|
ARMv7 hardware will not work.
|
2024-10-22 21:35:41 +00:00
|
|
|
Expected operating system usage is Linux. FEX has been tested with the following Linux OSes:
|
|
|
|
|
|
|
|
|
|
- Ubuntu 22.04
|
|
|
|
|
- Ubuntu 24.04
|
|
|
|
|
- Ubuntu 24.10
|
|
|
|
|
- Arch Linux
|
2022-01-04 00:05:05 +00:00
|
|
|
|
2021-03-21 08:53:51 +00:00
|
|
|
On AArch64 hosts the user **MUST** have an x86-64 RootFS [Creating a RootFS](#RootFS-Generation).
|
2019-07-13 09:41:34 +00:00
|
|
|
|
2021-03-30 08:38:33 +00:00
|
|
|
### Navigating the Source
|
|
|
|
|
See the [Source Outline](docs/SourceOutline.md) for more information.
|
|
|
|
|
|
2021-03-21 08:53:51 +00:00
|
|
|
### Building FEX
|
2022-09-02 17:43:07 +00:00
|
|
|
Follow the guide on the official FEX-Emu Wiki [here](https://wiki.fex-emu.com/index.php/Development:Setting_up_FEX).
|
2021-03-21 08:53:51 +00:00
|
|
|
|
|
|
|
|
### RootFS generation
|
|
|
|
|
AArch64 hosts require a rootfs for running applications.
|
|
|
|
|
Follow the guide on the wiki page for seeing how to set up the rootfs from scratch
|
2022-09-02 17:43:07 +00:00
|
|
|
https://wiki.fex-emu.com/index.php/Development:Setting_up_RootFS
|
2019-07-13 09:41:34 +00:00
|
|
|
|
|
|
|
|
|
