Getting started

Getting started with your emulator


Post setup

This guide is meant for middle-level people in regards to the Raspberry Pi. So if you need additional info, please don't hesitate to contact me

Having troubles logging in?
The login is pi and the password is raspberry. Please change this as quickly as possible (further down this page)

If you are having issues, please make sure you are up to date, and check the troubleshooting guide.

Please note that if the initial setup window is skipped, you cannot run the emulator until the runtime is installed when prompted.


Download the latest version from, and extract the ZIP. It may be automatically extracted, so it's just to move it to the applications folder, or anywhere else you wish.

You will then be prompted to set up the runtime, you may either choose 'overwrite' if already installed, 'provided' to install provided binaries, or simply press enter to use Brew, if installed. (Brew will require developer tools, and will be installed with the Brew Package Manager)

You will then be prompted to download and set up a disk image, which is necessary for the emulator to function.

The default image is a 'lite' version, which saves space (approx 0.8GB download)
If you wish to use the full disk image (approx 1.7 GB download), close any existing terminal window,z
1. open a Terminal window and type 'raspiemu disksetup'
2. type 'i'
3. type either 2 or 4, for either the Pi 1 or Pi 2.

If you are booting to 'CLI', there will be no Desktop - You must use 'GUI' mode for that.
If the GUI doesn't automatically start, type 'startx'.

Post Setup

To access via SSH, VNC, or another service, you must port forward the required ports, and enable the service within the emulation.
To enable SSH, ensure the port 22 is forwarded (done so by default), and run "
raspi-config" inside the emulator (preferrably CLI mode).
Select "Interfaces" with your keyboard, and enable "SSH".

To port forward, or use custom emulation arguments, or add a USB device, use the Config > Network menu bar item.

To set up a custom disk image, add a shared disk, or configure SMB, use the Config menubar item.
Wish to use your own boot disk? Visit this article on creating a bootable disk image of another operating system.

Moving on? Use the Help > Documentation menubar item in the application for more guides and tips.

Want to stay up-to-date with new versions?

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