Troubleshoot issues with your emulator
Please note that some steps may make use of the Command-Line, and may be harmful to your computer if used incorrectly. Even sufficient knowledge may result in more issues than what you started out with.

Network/internet doesn't work

RaspiEmu does its best to select the appropriate QEMU binary for your system; however sometimes it may not be choose the best one.
To mediate this, you can select a different version of QEMU from the Preferences window > Emulator tab.

The Pi 2 does not have TCP/UDP networking. The closest you can get is text-over-CLI, which is good for pasting text into files. Maybe this can be used to paste binary data, I am not to know.

Crashes on launch

Please make sure that your copy is up-to-date. The latest versions are available at, with pre-release versions available here. or via gumroad at

Make sure your system is compatible. The current stable OS is between OS X 10.8 and 10.12, with support for High Sierra a little unstable.

If your app is in a restart loop (will launch, then relaunch),
please update to version 2.7.6, or delete the file ~/Library/Preferences/us.snorfi.RaspiEmu.plist

No GUI, but CLI works

As of v2.8, this shouldn't be an issue. If you downloaded the image using a previous version, follow the steps below to re-download the disk image.
1. Open a Terminal window and type 'raspiemu diskconfig'
3. In the newly opened pop-up window, type 'd', followed by 'pi1' or 'pi2'.
This will delete the existing image, making space for the new one.
4. Once step 3 is complete, re-launch using step 1, and type 'i', (instead of 'd')
5. Enter either '2' or '4', which will download and install a full Raspbian image, approximately 1.7GB.

Pi 1/2 doesn't start

Try repairing the runtime. This can be done via Config > Configure runtime, by typing 'repair' when prompted. If you are prompted to install, then the runtime isn't set up - it's a good idea to follow through (by typing 'no' or 'yes')

Make sure you have entered valid arguments for QEMU. Try removing them by clicking the reset button in the Config > Emulation Arguments menubar item.

Make sure that your attached USB device is correct. Otherwise, try disabling it completely by clicking on "Change" in the Config > USB menubar item

If you are receiving 'not found' errors while in CLI, try re-downloading the disk image, as it is the boot disk. There's no way it'll work without it. This can be done via the Config > Configure Disk

As of version 2.7.14, Pi 2 GUI is disabled due to performance reasons. It can still be accessed via "combine"; the Start > Launch Pi 2 > GUI+CLI menu item.
Alternatively, it can be reenabled by enabling debug mode in the Preferences > General window.

Mouse doesn't work in Pi 2

This is a known issue, and will be fixed as soon as possible.
Workaround: Use CLI, "Combine" (accessible via Start > Pi 2 menu items), or the Pi 1 GUI instead.
Update: Apperently this occurred in version 2.7.9. You could try downgrading to version 2.7.8, available here

Final resort
If nothing of the above works, you could try a configuration reset by going to Preferences > Reset configuration.

blog comments powered by Disqus

This site uses cookies for quality of service and analytics, and is GDRP compliant.
You can read the privacy policy at