Installing AmiKit in FS-UAE

This tutorial will help you to install AmiKit in FS-UAE. Before you start, you should ensure you have FS-UAE Launcher and FS-UAE installed already, and that you have the required kickstart for Amiga 4000. You also need either the AmigaOS 3.5 or AmigaOS 3.9 installation CD, or an Amiga Forever CD.

Download and Extract AmiKit

Though a bit counter-intuitive you should download the Linux version no matter what your host OS is.

Though a bit unintuitive you should download the Linux version no matter what your host OS is.

It looks like there is a problem with the AmiKit Linux version, which prevents installation from working properly! Until that is fixed, this tutorial cannot be followed to completion.

First, you need to download AmiKit from the official download page. One important point is that you should download the Linux version of AmiKit regardless of what operating system your are using. This means that after downloading, you should have a file called AmiKit-linux-latest.zip. Now, open this zip file by whatever means you have, and extract the file AmiKit.zip found within (store in temporarily somewhere, for example on the desktop).

Now you need to decide where you want to have AmiKit stored. I suggest the following location: Documents/FS-UAE/Hard Drives/AmiKit, but you can put it anywhere you like. The rest of the tutorial will assume this location.

  1. Create Documents/FS-UAE/Hard Drives/AmiKit
  2. Extract the contents of AmiKit.zip to Documents/FS-UAE/Hard Drives/AmiKit (Make sure you don’t accidentally end up with Documents/FS-UAE/Hard Drives/AmiKit/AmiKit)

You should ideally use an extraction program where you can specify ISO-8859-1 / Latin-1 as the character set for the zip file, otherwise some file names will be incorrect. In Linux you can for example unzip with unzip -I latin1 AmiKit.zip

Prepare Installation Media

Here I have created an empty folder for AmiKit, and one for the AmigaOS3.9 installation files. Now the files needs to be extracted from the zip and copied from the CD.

Here I have created an empty folder for AmiKit, and one for the AmigaOS3.9 installation files. Now the files needs to be extracted from the zip and copied from the CD.

When AmiKit first boots up, it needs to perform installation of AmigaOS files, and it can get these files from one of the following sources:

  • Amiga Forever CD
  • AmigaOS 3.5 installation CD
  • AmigaOS 3.9 installation CD

If you have an ISO image of the CD, you can just add this to the CD-ROM drive selector in FS-UAE Launcher before starting the emulation.

If you have a recent Amiga Forever version which is distributes as an .msi installer, you can create an Amiga Forever CD ISO file from the Amiga Forever program.

If you have a physical CD, the easiest way to get FS-UAE/AmiKit to read the files correctly from the CD is to copy the CD contents to a temporary directory on your hard drive. The important thing is the name the folder the CD content is copied to, as this name will be reflected as the Amiga volume name. So like previously, you can store this somewhere else, but make sure the folder name is the same.

  • Amiga Forever CD: Create Documents/FS-UAE/Hard Drives/AmigaForever and copy the contents of the CD to this directory.
  • AmigaOS 3.5 installation CD: Create Documents/FS-UAE/Hard Drives/AmigaOS3.5 and copy the contents of the CD to this directory.
  • AmigaOS 3.9 installation CD: Create Documents/FS-UAE/Hard Drives/AmigaOS3.9 and copy the contents of the CD to this directory.

It looks like there is a bug in the AmiKit 8 distribution for Linux when installing with AmigaForever. It looks for a file called AmigaForever:Disk.info, which does not exist, and never has. This causes the installer to fail to recognized AmigaForever. An easy workaround is to create an empty Disk.info file inside AmigaForever.

Configure FS-UAE Launcher

Screenshot of FS-UAE Launcher, having selected the two hard drives.

Screenshot of FS-UAE Launcher, having selected the two hard drives.

  1. Click the “New Configuration” button in the main tab to ensure you are starting with a blank slate.
  2. Change Amiga model to Amiga 4000 (68040).
  3. Go to the hard drives tab and click on the folder button for the first hard drive. Browse to and select the AmiKit folder you’ve prepared.
  4. Click on the folder button for the second hard drive. Browse to and select the AmigaForever or AmigaOS3.5 or AmigaOS3.9 folder you’ve prepared.
  5. Go to the ROM & RAM options tab, check Zorro III Fast Memory, and choose 64 MB (or more if you like).
  6. Go to the Exceptions tab, set Graphics card = UAEGFX and UAE bsdsocket.library = Enabled.
  7. Go back to the main tab, change “Unnamed Configuration” to something of your liking, for example “AmiKit” and click the save button.

Finish the Installation in FS-UAE

AmiKit installer asking your what installation source medium you have.

Now you can start FS-UAE by clicking on the start button and you should boot directly into the AmiKit installation program.

  1. The AmiKit installer checks installation media one by one in a specific order, so if you have inserted AmigaForever as installation medium for example, the installer will ask you to insert AmigaOS XL (press cancel) and then AmigaOS3.9 (press cancel again) before proceeding.
  2. You’ll be asked a couple of questions during installation, you can simply pick the “Recommended” items.
  3. Installation should complete, and you can press enter to boot AmiKit.
Congratulations, AmiKit were successfully installed :)

Congratulations, AmiKit was successfully installed!

Congratulations, AmiKit should now boot 🙂

When AmiKit has started for the first time, the AmiKit live updater may appear and suggest downloading the latest AmiKit updates – which you can do if you like – or postpone it to later. After installing updates, and AmiKit reboots, the boot indicator might seem stuck for a few minutes while the updates are installing – just be patient!

Clean Up

We’ll now tie up a couple of loose ends (but everything will still work if you don’t do this):

  1. Quit FS-UAE so you’re back in FS-UAE Launcher.
  2. Go to the hard drives tab and “Eject” the second hard drive folder containing the installation media, leaving only the first hard drive with AmiKit.
  3. Go back to the main tab and click “Save Configuration” to update the config.

You can now delete AmiKit-linux-latest.zip and AmiKit.zip, or keep one of them for later installations. You can also delete the AmigaForever or AmigaOS3.5 or AmigaOS3.9 installation folder (or you can keep it lying around, your choice).

Additional Configuration

  1. You may want to enable the JIT compiler for greatly increased performance. Add the line jit_compiler = 1 to custom configuration.
  2. You may want to disable drive clicking (sounds) by adding the following line to custom configuration: floppy_drive_volume_empty = 0
  3. Remember to save the configuration if you have done any changes.