A script to configure a Minibian system as a dedicated Amiga emulation machine
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


AmiBerry v1

A script to configure a stock Minibian system as a dedicated Amiga emulation machine.

Note: This version is now deprecated, since v2 is out. The new version was built from the ground up to be better, so I'd recommend you use that instead. Get it from the official page


  • A Raspberry Pi 3 (recommended) or 2.
  • A stock Minibian installation.

Usage (for the lazy)

  • Download the latest image for your Pi model, from the Releases section.
  • Flash it to an sdcard.
  • Boot your Raspberry Pi from the sdcard.

Usage (for the not so lazy)

wget --content-disposition https://git.io/v6uH9
sh ./amigapi

What next?

The tool will present you with a menu containing all available options. You should start with expanding the filesystem, Upgrading the system and finally install AmigaPi. Once you install AmigaPi, the system will be configured to boot straight into UAE.

You can configure your setup and once you're happy, untick the option "Show GUI on startup" in UAE's Miscellaneous page, to boot straight into Workbench from that moment on. You can always quit UAE to go back to your normal (Linux) login screen.

You can re-run the tool to perform any of the tasks it handles, including upgrading your system, upgrading UAE, enabling/disabling system options as well as the UAE service, etc.

Known issues

  • You can freely upgrade the system, but if you upgrade the firmware as well (rpi-update) then uae4arm will break. This problem has been reported to the author of uae4arm here, until it's fixed with a new version, please don't upgrade the firmware.


  • If you're having problems with UAE, please refer to the uae4arm-rpi [project page by Chips-fr] (https://github.com/Chips-fr/uae4arm-rpi).
  • If you find a bug in the amigapi tool, please let me know by opening an Issue on the Github page.

Troubleshooting WiFi

If your wlan0 is not working after rebooting, you're probably missing kernel firmware for your wireless network adapter.

Just check dmesg for entries looking like:

r8188eu 1-1.5:1.0: Firmware rtlwifi/rtl8188eufw.bin not available

and use apt-file to find the corresponding package containing this firmware:

apt-file update
apt-file find rtl8188eufw.bin

which will result in:

firmware-realtek: /lib/firmware/rtlwifi/rtl8188eufw.bin

and then install the required package:

apt-get -y install firmware-realtek

Now unplug and reinsert the wireless adapter or reboot.