Documentation topics are available from the documentation menu to the right. Some common issues and questions are answered here in FAQ and Troubleshooting.

If you have just installed FS-UAE, you might want to take a look at the getting started-guide first! As the getting started-guide mentions, you should ideally have Kickstart ROMs for the Amigas you want to emulate.

While you are running the emulator, you can open the FS-UAE menu or use keyboard shortcuts to control the emulator.

Configuration Files

If you use FS-UAE Launcher, you don’t have worry about configuration files, but when you use FS-UAE directly, you need to specify options either as program arguments or via configuration files.

103 thoughts on “Documentation

  1. Apologies for being a new user with no knowledge here, but running FS-UAE on a MAc and games are working, but I cannot seem to save games (Sierra On-line adventure games etc…).

    Its probably as I have no idea what Im doing and most uses in the emulator are trial and error for me, but a step by step guide would be really appreciated if you can assist?

    Thanks in advance!

    • Is the problem that you don’t know how to access the save game function in Sierra adventure games, or that you use it, but it does not appear to work?

  2. Hi Frode!

    Thanks for your great work!
    I asked a while ago, why there is no Amiga 2000 Emulation in the dropdown. You told me to use A500. But are the Zorro-Busses working, when using a A500 Emulation?

    Best regards Marc

  3. First of all – many thanks to the Developer of this famos package. i just installed it with OS3.9, and 68060 support (cypberppc) – very similar to my old hardware (A4000) i still own. This is the first UAE implementations where nearly all is running relly smooth on a Linux (Fedora24) host system.
    Just one question – i didn’t find any helpfull information about howto configure the A2065 (or any other full Network support).
    I use the FS-UAE on a laptop which is equipped with a 1GBit Ethernet and a wifi interface. How can i configure FS-UAE to use the Wifi Interface to connect to with a2065. Since i want to try install and run my old Mailbox Software (Excelsior) with a netser (telser.device). This network tools are not working with the bsdsocket.library support – if i start any tool (like telnet) out of the genesis stack (OS3.9) fs-UAE urgently crashes.

    • Hi, please make sure you are using the latest 2.8.1 version of FS-UAE. You can use the option network_card = a2065 (or use a corresponding GUI control in FS-UAE Launcher) to enable A2065 🙂

      • Hello,
        i already activated the a2065 option in the fs-uae-launcher. also i installed a actual version of the a2065.device driver in the AmigaOS, and load this device in the genesis stack.
        i can start up the stack, and put the interface online. After that, I’m able to ping my own (genesis) IP Address, but no address outside of the amiga – even not the configured default router.
        i think, this is cause fs-uae does not know on which interface the a2065.device must work – if it is using the 1st one (this is the ethernet device), there will be no connection, cause i’m using only the WLAN device.

        • Hi, are you sure it is not working? Ping may not work though. I think ICMP messages are not relayed. FS-UAE does not need to know about the host interface(s), the networking support basically uses a form of NAT.

  4. I’ve (permanently?) lost an entry, War In Middle Earth, from my Games list (synced from the online database) in FS-UAE on Windows 10, not sure how it happened or how to get it back, even after uninstalling & reinstalling the program. Repro, as best as I can recall:

    1) Downloaded FS-UAE with files for the game on local HDD, wasn’t familiar with how to start so I created a Config named WarInMiddleEarth.

    2) Found out how to register and sync to the online game database, at which point my WarInMiddleEarth Config showed up alongside the War In Middle Earth game entry from the database. Managed to get the game running at least once using the default ADF variant.

    3) Became interested in how to get the game running through WHDLoad v1.0. Found that I didn’t have the correct kickstarter for Amiga 1200, located and installed the correct file.

    4) Around this time, the War In Middle Earth entry disappeared from my Games list. When viewing Configs and Games, I was able to see my WarInMiddleEarth config, but no War In Middle Earth game next to it. All the rest of the games (several dozen) appear to be listed correctly.

    5) After re-syncing to the database and attempting other fixes, I saw no alternative but to uninstall the program, delete the Documents\FS-UAE folder, then reinstall. I logged into the database on the fresh install, at which point it downloaded the game database. War In Middle Earth is still nowhere to be found.

    I’m unsure of what else to try – I’ve verified that War In Middle Earth is still present in the database by looking it up online; it hasn’t been removed in the last 24 hours or anything like that. Feels like I might need to edit or delete some registry entry or hidden file to force FS-UAE to properly download and display the complete games list. Any help would be greatly appreciated!

    • Hi, one variant for this entry (ADF, cr ESI, h Invisible Crime) was removed earlier this year because it was discovered that one of the disks was corrupt, maybe you only had the disks for that specific variant? Another possibility is that you have run FS-UAE or another Amiga emulator with writable ADF disks, and saved a game or something, so the disks are no longer recognized (the database will only recognize unmodified disks, and FS-UAE will by default not modify the original .adf files).

      If possible, I’d try to get hold of fresh .adf files for the game (or, if you know how, verify the checksums for the disks).

      (You can also go into Settings -> Game Database and choose to show all games, just to verify that the local database contains the game. You will not be able to start it with files missing though)

      • Thank you very much for the fast reply! The problem was that I didn’t understand that I was only being shown a limited subset of games, which included War In Middle Earth only because I happened to have it installed in the correct location before experimenting with FS-UAE for the first time. I must have broken the game files which caused the game to stop appearing in the list. Now I’m all set up with both the ADF and WHDLoad variants. Cheers!

  5. Hi,
    Out of the blue FS-UAE has stopped working for me, citing this:

    Amiga Launch Task failed with FileNotFoundError:
    “[Errno 2] No usable temporary directory found in [‘/tmp’, ‘/var/tmp’, ‘/usr/tmp’, ‘/home/luke’]”

    I’d only been using it for a few days and I haven’t installed any other programs since installing it. If it means anything, I started having problems with saved states shortly before this happened.

    Since I’m not terribly computer savy I went to do an old uninstall-reinstall but clicking uninstall does absolutely nothing for some reason.

    It’d be great if you could help…you got me hooked!! 🙂


  6. FS-UAE 2.6.2 on Ubuntu 14.10LTS 64Bit will not load anything get Amiga crash screen reporting not enough memory, 4GB installed, less than 800mb in use, plenty of space in /usr dir. Please help.

  7. just managed to get an Xbox 360 controller working with a witeless adaptor…only £5 on Amazon. but can’t see Ho to enable two Xbox 360 controllers

    • Microsoft’s XBox 360 wireless adapters allows up to 4 XBox 360 controllers to be connected. All of them should be seen by FS-UAE Launcher.

  8. Many thanks for all the work. Only, could you please, please, please enable left handed mouse use (switching of left and right mouse button)? So many people would be so grateful. Not having this is such a deal breaker for me and many other folks, as it makes many games quite unplayable and many another software unusable. To know why this is such a big deal, just try to use a pair of “normal” scissors effectively with your left hand. In my case, I get inflamed tendons from a single session with a “normal” right handed mouse configuration (or from sticking with mismatched scissors). Just can’t do.

    In the meantime, is there a way I could map the left click to a key on the keyboard? I’d appreciate


Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.