Repository files navigation

This is set of recipes for building retrocomputing emulators as Docker images.

The goal is to make retro systems easy to run and composable.

A full build will provide you with the following emulators.

We also provide scripts for building some system images.

At a low priority, we package some cross toolchains for retro development.

The build is simple. It requires Internet access and may fail on occasion tue do upstream issues:

$ ./build-emulators.sh$ ./build-systems.sh

Once you have some images, most of them will give you an instant shell:

$ docker run --rm -ti retroprom/simh-pdp11-unix-v7PDP-11 simulator Open SIMH V4.1-0 Current        git commit id: 09f67aa0Disabling XQ@boot     New Boot, known devices are hp ht rk rl rp tm vt: rl(0,0)rl2unixmem = 177856# Restricted rights: Use, duplication, or disclosureis subject to restrictions stated in your contract withWestern Electric Company, Inc.Thu Sep 22 05:47:36 EDT 1988login: rootPassword:You have mail.#

IBM mainframe images will launch TMUX and Hercules. Terminal attach must be done manually - for now.

Feel free to send patches or ask questions.

This is obviously a hobby project.

Images are currently based on Debian (release 12/bookworm).

The images use a build container to minimize image size.

A simulator user called 'sim' is usually provided.

Emulators are installed in /usr/local when possible.

Other simulator files are located in /sim.

Images should be set up to start the emulator using dumb-init.

System images usually start in the foreground and require a terminal.

The Docker console and 'sim' user get full control over the simulator.

Console sessions are logged in with admin privileges for convenience.

This package is - for the moment at least - in the public domain.

In legislatures without a public domain, CC0 may be applied instead.

This software is providedwithout any warranty - express or implied.

It is intended forhobby, research and training use only.

Images built will containlicensed materials owned by third parties.

Many of the systems provided arelimited to non-commercial use.

This package itself contains no licensed material from third parties.

All users are advised to carefully analyze the legal situation.