Getting Started with Amiga Development

Set up your tools for Amiga 68000 assembly programming.

What You Need

To develop for the Amiga, you need three things: a way to compile your code, an emulator to run it, and Kickstart ROMs.

⚙️ Dev Toolchain

Our Docker image includes vasm assembler and amitools for disk creation.

Install

docker pull code198x/commodore-amiga

Compile

docker run --rm -v "$(pwd)":/code -w /code \
  code198x/commodore-amiga \
  vasmm68k_mot -Fhunkexe -kick1hunks -o game game.asm

Create Bootable Disk

docker run --rm -v "$(pwd)":/code -w /code \
  code198x/commodore-amiga bash -c \
  "echo game > s && xdftool game.adf create + format Game + \
   boot install boot1x + makedir s + write s s/startup-sequence + \
   write game && rm s"

🖥️ Emulator

Install an Amiga emulator natively for the best experience.

macOS / Linux

brew install --cask fs-uae  # macOS
sudo apt install fs-uae     # Linux

Windows — Download WinUAE

Kickstart ROMs

Amiga emulators require Kickstart ROM files:

Run

fs-uae --floppy_drive_0=game.adf

Ready to Build

Your tools are set up. Time to write some code.

Start with Assembly →