Running Stak Scheme as Docker containers

This page describes how to run pre-built Docker images of Stak Scheme and its utility commands. By reading this page, you will learn:

• What Docker images are available for the Stak Scheme interpreter and its utilities.
• How to run such Docker images on your local machine.

By using the Docker images, you can try out Stak Scheme without building or installing it on your local machine.

Docker images

We provide several Docker images for Stak Scheme and its utilities. The images are hosted on Docker Hub as listed below.

Image name	Link	Description
stak		Interpreter
stak-repl		REPL
mstak		Minimal interpreter

Advanced utilities

The following table lists advanced utility commands built as Docker images.

Image name	Link	Description
stak-compile		Bytecode compiler
stak-decode		Bytecode decoder
stak-interpret		Bytecode interpreter
stak-profile		Bytecode profiler
mstak-interpret		Minimal bytecode interpreter

Running Docker containers

Interpreter

To run the Docker image of the stak interpreter with a Scheme script file named hello.scm, use the following command:

docker run -it --rm -v ./hello.scm:/hello.scm raviqqe/stak hello.scm

Note that you need mount the Scheme file onto the Docker container so that the stak command can access it inside the container.

REPL

To run the Docker image of the stak-repl REPL command, use the following command:

docker run -it --rm raviqqe/stak-repl