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
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.
- 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
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/AmigaForeverand copy the contents of the CD to this directory.
- AmigaOS 3.5 installation CD: Create
Documents/FS-UAE/Hard Drives/AmigaOS3.5and copy the contents of the CD to this directory.
- AmigaOS 3.9 installation CD: Create
Documents/FS-UAE/Hard Drives/AmigaOS3.9and 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
- Click the “New Configuration” button in the main tab to ensure you are starting with a blank slate.
- Change Amiga model to Amiga 4000 (68040).
- Go to the hard drives tab and click on the folder button for the first hard drive. Browse to and select the
AmiKitfolder you’ve prepared.
- Click on the folder button for the second hard drive. Browse to and select the
AmigaOS3.9folder you’ve prepared.
- Go to the ROM & RAM options tab, check Zorro III Fast Memory, and choose 64 MB (or more if you like).
- Go to the Exceptions tab, set Graphics card = UAEGFX and UAE bsdsocket.library = Enabled.
- 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
Now you can start FS-UAE by clicking on the start button and you should boot directly into the AmiKit installation program.
- 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.
- You’ll be asked a couple of questions during installation, you can simply pick the “Recommended” items.
- Installation should complete, and you can press enter to boot AmiKit.
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!
We’ll now tie up a couple of loose ends (but everything will still work if you don’t do this):
- Quit FS-UAE so you’re back in FS-UAE Launcher.
- Go to the hard drives tab and “Eject” the second hard drive folder containing the installation media, leaving only the first hard drive with
- Go back to the main tab and click “Save Configuration” to update the config.
You can now delete
AmiKit.zip, or keep one of them for later installations. You can also delete the
AmigaOS3.9 installation folder (or you can keep it lying around, your choice).
- You may want to enable the JIT compiler for greatly increased performance. Add the line
jit_compiler = 1to custom configuration.
- You may want to disable drive clicking (sounds) by adding the following line to custom configuration:
floppy_drive_volume_empty = 0
- Remember to save the configuration if you have done any changes.