RetroPie Project SD-card Image V2.3

Size1.2 GB
Create Date05/31/2014
Last Updated07/21/2014

This is an SD-card image with a ready-to-go RetroPie installation. It needs an SD-card with at least 4 GB space.

As a first alternative, you can download the image via BitTorrent Sync. The secret is BTPRFQU2LYC4IWTQKUEDYBUNGKZ4H3MY6 You might find that using this way for downloading is faster than the direct download.
As a second alternative you could use the mirror.
The SHA1 sum of the download is


The default user/password that comes with Raspbian is used: The username is "pi", the password is "raspberry".

If you would like to access the RPi as root, you can use the username "root", together with the password "raspberry".

How to Install the Image

Basically, you just have to extract and copy the image to an SD card (at least 4 GB large) in the same way you install the official Raspbian image. A tutorial about this that is written by the RPi community can be found here. If you use a Linux platform or a Mac, you can use, e.g.,  the following instructions:

  1. Check file integrity via
  2. Unzip with

    or with any archive program, e.g., 7-ZIP.

  3. Put the SD card into you RPi, e.g., with the "dd" command or Win32DiskImage, start it. The front-end "Emulation Station" starts automatically.
  4. If your SD card is larger than 4 GB, you need to expand the root file system in order to use the whole SD catrd. Go into the shell by pressing F4. Run
    sudo raspi-config

    and choose "expand root fs" from the menu. You need to restart your RPi afterwards.

  5. You need to copy ROMs and, if you want to use it, a NeoGeo bios to the corresponding roms and bios folders.
  6. Enjoy your RetroPie installation :-) If you have questions, comments, or suggestions feel free to post them in the comments, the forum, or at Github.

Change log

The complete commit history of the RetroPie Script can be found here.

Version 2.3

  • Several bug fixes

Version 2.2

  • Added Mednafen PCE Fast
  • Fixed configurations for sega32x, segacd
  • Updated SAMBA configuration
  • Fixed imame4all-rpi rom dir configuration
  • Updated Python help scripts

Version 2.1

  • Fixed black screen when exiting to console
  • Fixed Doom Shareware starter
  • Removed hidden meta data files from FBA and Megadrive rome directory

Version 2.0

  • Reorganized folder structure (root dir is now /opt/retropie)
  • Complete rebuild of all binaries with latest versions
  • EmulationStation 2 as new front-end
  • Added MSX emulator OpenMSX
  • Refactored RetroPie-Setup Script with command line capabilities

Version 1.10.1

  • Updated Raspbian to the latest packages
  • Updated the default splash screen
  • Added x86 emulator FastDosbox

Version 1.9.1

  • Fixed "freezing" bug

Version 1.9

  • Added emulator Mame4All-RPi
  • Added emulator Mupen64Plus-RPi
  • Added splash screen configuration to RetroPie Setup Script
  • Added configuration menu for RetroArch NetPlay to RetroPie Setup Script
  • Enhanced debug log functionality of RetroPie Setup Script

Version 1.8.1

  • Added freezing fix for Emulation Station
  • Re-added source-based installation function for PC-Engine Libretro core

Version 1.8

  • Added (Libretro based) Genesis emulator Picodrive
  • Added emulator PiFBA
  • Updated Emulation Station, x86 emulator, and RetroArch to latest release

Version 1.7

  • Added ES-Config
  • Added Atari 2600 emulator Stella
  • Updated Emulation Station, x86 emulator to latest releases

Version 1.6.1

  • Fixed GPSP binary

Version 1.6

  • Added emulator Basilisk II
  • Added Dispmanx
  • Updated every installable component
  • Enhanced script for switching between resolutions

Version 1.5

  • Added emulator gpSP
  • Added emulator SNES9X-RPi
  • Added emulator PiSNES
  • Added GPIO gamepad drivers
  • Updated Emulation Station
  • Updated rpix86

Version 1.4.1

  • Updated Emulation Station
  • Updated rpix86

Version 1.4

  • Added system-dependent change of HDMI video resolution for increased performance for RetroArch-based emulators.
  • Added automatic USB ROM-copy service
  • Added x86 emulator rpix86
  • Added Apple ][ emulator Linapple
  • Enhanced themes

Version 1.3.1

  • Minor changes in the file organization

Version 1.3

  • Added NXEngine / Cavestory
  • Updated DGEN to version 1.32
  • Enhanced pre-defined RetroArch input configuration

Version 1.2.1

  •  Resized partition so that the image fits on 4 GB cards

Version 1.2

  • Added Intellivision emulator
  • Added SAMBA share installation and configuration
  • Used binaries-based setup for generating the SD-card image
  • Updated themes

Version 1.1

  • Added AdvMAME emulator
  • (Re-)added Genesis-GX RetroArch core
  • Added Final Burn Alpha emulator


  • Mad2UX

    Magnet link?

    • John Doe

      This. I don’t want to use BitTorrent’s closed source sync, use a legitimate torrent.

  • Aikon

    Link doesn’t work, managed to download a .sync file but even after renaming it to .zip it doesn’t work :(

    • petRockBlog

      Version 2.1 is uploading right now. If you use BitTorrentSync you do not have to wait until the upload has finished.

      • Aikon


      • Aikon

        Although I can’t get TorrentSync to start the download :(

      • zSprawl

        Mirror site always seems up first. :)

  • leffalompen

    Is 2.1 working / downloadable now?

    • leffalompen

      It seems to be :)

  • DSantos

    What did you do to fix the black screen when exiting to console in 2.1?

  • Stinow

    AWESOME image mate. Will donate something for sure soon. This is great software!

    Trying to get controller to work and trying to logon as root, but is the password changed?
    I’m trying to logon as root so I have rights to edit /opt/retropie/configs/all

    “If you would like to access the RPi as root, you can use the username “root”, together with the password “raspberry”.

    I try it using:

    su root


    Doesnt work though: “su authentication failure”.

    Hope you can help me out. Thanks!

    • petRockBlog

      Might be that version 2.1 does not have the root account activated. You could do that yourself by calling passwd in the console.

      Version 2.2 of the RetroPie image is uploading right now and has this included for sure.

      • Stinow

        Thanks you both! It’s working now :).

        Did the sudo -s to get to root account and then passwd to change the password.

        Now for getting the mame set roms to work :D

    • zSprawl

      Just type “sudo -s” to access root.

  • braedom

    Everything works great thanks though if you try to autoscrape it fails everytime and freezes the rpi.

    Also the cmd likes to resize itself but that was an easy fix. Any way to do the scraper without manually goung through all 2000 games (auto)

    • braedom

      Also! Does emulationstation 2s front end not have sound? For scrolling through emulators and games

  • smartroad

    Can’t download :( Mirror says been downloaded too much and torrent – I can’t seem to download the client from the website. Will keep trying!

  • Arrierito Soy

    Hello! I installed the image sd 2.3 and the xbox controller doesn´t work with mame roms, however, it works with the other systems (genesis, neogeo, snes). I am newbie;-) Can anyone help, please? Thank you very much.

    • Cappn

      I’m having the same issue

      • Arrierito Soy

        Solved! It was simple but novices little things cost us a lot;-)

        You have to enter the Mame menu by pressing “TAB” and set the command from there.

  • zSprawl
  • Mark

    I do not know if its just me but I can no longer download the image, when I press the download button it just loads for 10 min then stops. I have tried all of the alternatives and tried all three different browsers AND IM LOSING MY PATIENTS especially after picking up a nasty virus that i cant get off my pc.

    • Luke

      I am having the same problem.

    • Poo

      Are you a doctor?

    • mchid

      have you tried relenza or oseltamivir? JK. But seriously, you can use windows powershell to download the file to the current directory using the following command:
      Invoke-WebRequest -OutFile

  • Spanner Nick

    why is there on the sd image only 3 emulators,IBM,Apple II(does not work) and ports..??

    • Benjamin Cyr

      same issue here… not sure what step i am missing

      • therel

        You have to add ROMs for the other emulators to appear. You add ROMs to /home/pi/RetroPie/roms/{console}

  • Spanner Nick

    does the sega cd work in this..?

  • Mark

    Check sums do not match

  • snipe

    I have a 16GB SD card. A developer helped me get Raspberrian Wheezy on the card and partitioned the card. I want to get the image of retro pi on there to use. I am on a imac that can take an SD card what steps can I follow to get retro pi on the card using terminal on mac. I have seen many sites about this and most seem to only explain it from a windows perspective. Also should I not have installed raspberry wheezy and partitioned my card? I mjust not sure what exact steps to follow next.

  • generalconsensus

    sha is different now for RetroPieImage_ver2.3.img, please update when you can

    • petRockBlog

      The SHA1 sum is calculated for

  • deusatiam

    For some reason I don’t have any other folders in the …/RetroPie folder. There’s supposed to be a …/RetroPie/emulators folder, so now I can’t configure the controller options. What do I do?

  • Krister Pettersson

    how i get my rom from my collection work its over 30 gb and its on a usb stick and i have only a 4 gb on sdhc card ?

%d bloggers like this: