docker-amiga-gcc/README.md

3.0 KiB

AmigaDev Docker Crosstools

Currently AmigaOS 3.x, AmigaOS 4.x and MorphOS 3.9+ are supported. WarpOS and AROS will get supported in the forseeable future

Supported toolchains

Platform Toolchain Supported
AmigaOS 3.x @bebbo toolchain - gcc 6 Yes
AmigaOS 4.x @sba1 adtools - gcc 8 Yes
MorphOS 3.9+ MorphOS Team SDK 3.14 - gcc 9 Yes
~WarpOS~ ~gcc 6~ Not yet
~AROS ABIv1 x86_64~ ~AROS Team Official - gcc 9~ Not yet
~AROS ABIv1 x86~ ~AROS Team Official - gcc 9~ Not yet
~AROS ABIv0 x86~ ~AROS Team Official - gcc 9~ Not yet
~AROS ABIv1 ARM BE (RasPi)~ ~AROS Team Official - gcc 9~ Not yet

Build the Docker container

Example for AmigaOS 4.x toolchain:

docker build -t "amigadev/crosstools:ppc-amigaos" --build-arg BUILD_OS=AmigaOS --build-arg BUILD_PFX=ppc-amigaos -f Dockerfile .

For other toolchains, use the appropriate parameters:

  • AmigaOS 3.x (M680x0): --build-arg BUILD_OS=AmigaOS --build-arg BUILD_PFX=m68k-amigaos

  • AmigaOS 4.x (PPC): --build-arg BUILD_OS=AmigaOS --build-arg BUILD_PFX=ppc-amigaos

  • MorphOS (PPC): --build-arg BUILD_OS=MorphOS --build-arg BUILD_PFX=ppc-morphos

Run the Docker container for compiling a third party application

AmigaOS4.x example:

docker run

    # Destroy the container, once exited.
    # Comment this line out if you want to keep container after execution
    # for debugging
    --rm \

    # expose to the container the following local directories
    # format is:
    # <local_dir>:<container_dir>
    -v ${PWD}:/work \
    -v /path/to/extra/ppc-amigaos/lib:/tools/usr/lib \
    -v /path/to/extra/ppc-amigaos/include:/tools/usr/include \

    # Pass current UID and GID to container, so that it can change the
    # ownership of output files which are otherwise writen to outdir as
    # root
    -e USER=$( id -u ) -e GROUP=$( id -g ) \

    # Use this Docker image and then enter into it using the shell
    -it amigadev/crosstools:ppc-amigaos /bin/bash

AmigaOS3.x example

docker run --rm \
    -v ${PWD}:/work \
    -v /path/to/extra/m68k-amigaos/lib:/tools/usr/lib \
    -v /path/to/extra/m68k-amigaos/include:/tools/usr/include \
    -e USER=$( id -u ) -e GROUP=$( id -g ) \
    -it amigadev/crosstools:m68k-amigaos bash

MorphOS example

docker run --rm \
    -v ${PWD}:/work \
    -v /path/to/extra/ppc-morphos/lib:/tools/usr/lib \
    -v /path/to/extra/ppc-morphos/include:/tools/usr/include \
    -e USER=$( id -u ) -e GROUP=$( id -g ) \
    -it amigadev/crosstools:ppc-morphos bash

AROS (v1) x86_64 example

docker run --rm \
    -v ${PWD}:/work \
    -v /tmp/aros:/tmp/aros \
    -e USER=$( id -u ) -e GROUP=$( id -g ) \
    -it amigadev/crosstools:x86_64-aros bash
  • ${PWD} is the current dir
  • /path/to/extra are if you want to add any extra libraries

Bugs / Support / Issues

Please inquire about any support, bugs or issues in the Github issue tracker on this repository and I'll try to help as best I can.

// Marlon Beijer @ AmigaDev Team