fimage: A Shell repository from nealmcb

title	permalink	summary
Portable Fuchsia Emulator (FImage)	os/fimage.html	Explanation of the FImage tool, and its usage

Portable Fuchsia Emulator (FImage)

Note

FImage is provided for the convenience of developers and enthusiasts who don't want to compile Fuchsia. We are in no way connected to Google. For more information, see fimage/LICENSE.

TL;DR

The FImage emulator can be downloaded here.
For more information on the Fuchsia Emulator, see this document.

To quickly run FImage, use the commands below inside of it's folder:

./ffx-linux-x64 platform preflight
./network-config
./fimage-gui 4096

Recommended Requirements

8GiB of RAM or more
an Intel processor produced after 2010 (If you have a dedicated GPU)
A 4th generation Intel processor (If you do not have a dedicated GPU)
Ubuntu 20.04 or equivalent
curl, unzip,git
Up-to-date graphics drivers

Fimage Quick Start

First, download the latest Fimage tool at fimage/releases. Extract the file fimage-210525.zip and go into the fimage folder.

Begin by checking your hardware, using the provided ffx tool. FFX Documentation on fuchsia.dev

./ffx-linux-x64 platform preflight

This will print information about the hardware and software. If you are missing any dependencies or lacking hardware, it will let you know. The most common error is related to a lack of a supported GPU, to negate this, FImage uses software rendering by default, which may affect performance. If you have a supported GPU, use the fimage-gui-hostGPU script.

After following the instructions generated by the ffx preflight checks, you will need to configure networking, using the command below. This will configure the network interfaces for FEMU.

./network-config

Finally, the emulator is ready to run! Select one of the different launch options and use that to launch the emulator.

The command syntax is the same for each option. For example, to launch an FImage instance with 4GiB of RAM and a GUI, use:

./fimage-gui 4096

The launch options are as follows:

fimage-headless - Fuchsia emulator using only the command line
fimage-gui - Fuchsia emulator with the FEMU interface and the Ermine user shell
fimage-gui-hostGPU - Same as fimage-gui, using hostGPU; if supported

Known Issues